You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Remove algolia search if site config is not enable ([#283](https://github.com/kakawait/hugo-tranquilpeak-theme/issues/283))
8
+
- Site config `coverImage` is more consistent with other existing image config, refer to _breaking changes_ ([#327](https://github.com/kakawait/hugo-tranquilpeak-theme/issues/327))
9
+
-`param``coverImage` if relative now based on site base url ([#236](https://github.com/kakawait/hugo-tranquilpeak-theme/issues/236))
10
+
- Fix `grunt` build to support newer `node` version ([#315](https://github.com/kakawait/hugo-tranquilpeak-theme/issues/315))
- Add swedish translation ([#345](https://github.com/kakawait/hugo-tranquilpeak-theme/pull/345)) (thank you [flojon](https://github.com/flojon))
13
+
14
+
### Breaking changes
15
+
16
+
Do not support anymore Hugo version <= 0.30!
17
+
18
+
`coverImage` from `config.toml` now more consistent by do not fix default static folder to `images` (see [#327](https://github.com/kakawait/hugo-tranquilpeak-theme/issues/327) for more details).
19
+
`coverImage` from `param` will now always based on base path and not relative to current url, thus
- Revamp _open sidebar_ behavior to not push the content out of container ([#278](https://github.com/kakawait/hugo-tranquilpeak-theme/issues/278)) (thank you [johnsoncodehk](https://github.com/johnsoncodehk))
@@ -23,7 +49,7 @@ Since I did an error on `highlight.js` for parameter `syntaxHighlighter`, sorry
23
49
```toml
24
50
[params]
25
51
syntaxHighlighter = "highlight.js"
26
-
```
52
+
```
27
53
28
54
## [0.4.2-BETA](https://github.com/kakawait/hugo-tranquilpeak-theme/milestone/17) - 1 nov 2017
29
55
@@ -107,7 +133,7 @@ With new _Sharing options_ that allow extensible list of sharing options, there
107
133
108
134
### Breaking changes
109
135
110
-
Do not support anymore Hugo version < 0.20!
136
+
Do not support anymore Hugo version < 0.20!
111
137
112
138
## [0.2.3-ALPHA](https://github.com/kakawait/hugo-tranquilpeak-theme/milestone/12) - 31 mar 2017
After installing the Tranquilpeak theme successfully, we recommend you to take a look at the [exampleSite](exampleSite) directory. You will find a working Hugo site configured with the Universal theme that you can use as a starting point for your site.
100
+
After installing the Tranquilpeak theme successfully, we recommend you to take a look at the [exampleSite](exampleSite) directory. You will find a working Hugo site configured with the Tranquilpeak theme that you can use as a starting point for your site.
101
101
102
102
First, let's take a look at the [config.toml](exampleSite/config.toml). It will be useful to learn how to customize your site. Feel free to play around with the settings.
Copy file name to clipboardExpand all lines: docs/developer.md
+24-26Lines changed: 24 additions & 26 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
# Developer documentation #
2
2
3
-
This documentation will help you to understand Tranquilpeak Hugo theme code.
3
+
This documentation will help you to understand Tranquilpeak Hugo theme code.
4
4
5
5
If you want to report a bug or ask a question, [create an issue](https://github.com/kakawait/hugo-tranquilpeak-theme/issues/new).
6
6
@@ -28,8 +28,8 @@ If you want to report a bug or ask a question, [create an issue](https://github.
28
28
## General ##
29
29
30
30
-**Author** : Thibaud Leprêtre
31
-
-**Version** : 0.4.4-BETA (based on Hexo version 1.10.0)
32
-
-**Compatibility** : Hugo v0.20.1
31
+
-**Version** : 0.4.5-BETA (based on Hexo version 1.10.0)
32
+
-**Compatibility** : Hugo v0.30
33
33
34
34
## Requirements ##
35
35
@@ -45,16 +45,14 @@ If you want to report a bug or ask a question, [create an issue](https://github.
45
45
5. Install [requirements](#requirements)
46
46
6. Run `npm install` to install [NPM dependencies](#npm-dependencies)
47
47
48
-
If you want to configure the theme, please follow the [user documentation](https://github.com/kakawait/hugo-tranquilpeak-theme/blob/master/docs/user.md)
48
+
If you want to configure the theme, please follow the [user documentation](https://github.com/kakawait/hugo-tranquilpeak-theme/blob/master/docs/user.md)
49
49
50
50
## Code style ##
51
51
52
-
We use [ESLint](http://eslint.org) based on Google code style to maintain javascript code style.
52
+
We use [ESLint](http://eslint.org) based on Google code style to maintain javascript code style.
53
53
Check code style with :
54
54
```bash
55
55
npm run lint
56
-
# or
57
-
grunt eslint
58
56
```
59
57
60
58
## Code structure ##
@@ -76,7 +74,7 @@ tranquilpeak
76
74
77
75
<!--### Languages ###
78
76
79
-
Each files contains all labels used in the theme.
77
+
Each files contains all labels used in the theme.
80
78
If you want to add a new language, duplicate an existing language file and replace all string by their translation.-->
81
79
82
80
### Views
@@ -99,10 +97,10 @@ If you want to add a new language, duplicate an existing language file and repla
99
97
100
98
#### Stylesheets
101
99
102
-
SCSS structure follow 7-1 pattern of [sass guidelines](http://sass-guidelin.es/#the-7-1-pattern)
103
-
If you want more information and to understand better this code, consult [sass guidelines](http://sass-guidelin.es/)
100
+
SCSS structure follow 7-1 pattern of [sass guidelines](http://sass-guidelin.es/#the-7-1-pattern)
101
+
If you want more information and to understand better this code, consult [sass guidelines](http://sass-guidelin.es/)
104
102
105
-
#### Images
103
+
#### Images
106
104
107
105
```
108
106
├── images
@@ -111,8 +109,8 @@ If you want more information and to understand better this code, consult [sass g
111
109
|File|Description|
112
110
|---|---|
113
111
|cover.png|Default background cover of the blog|
114
-
115
-
Contains all images of the theme.
112
+
113
+
Contains all images of the theme.
116
114
117
115
#### Javascript
118
116
@@ -148,13 +146,13 @@ Contains all images of the theme.
148
146
|smartresize.js|Debouncing function from [John Hann](https://github.com/unscriptable)|
149
147
|tabbed-codeblocks.js|Animate tabs of tabbed code blocks|
150
148
|tags-filter.js|Filter posts by using their tags on archives page : `/tags`|
151
-
152
-
Each file correspond to a feature.
153
-
149
+
150
+
Each file correspond to a feature.
151
+
154
152
## NPM scripts
155
153
156
-
Use `npm run <script_name>` to run one of these scripts. E.g : `npm run start`
157
-
154
+
Use `npm run <script_name>` to run one of these scripts. E.g : `npm run start`
155
+
158
156
|`npm run ...`|Description|
159
157
|---|---|
160
158
|`start`|Build the theme once and rebuild after each change|
@@ -163,14 +161,14 @@ Use `npm run <script_name>` to run one of these scripts. E.g : `npm run start`
163
161
164
162
## Grunt tasks ##
165
163
166
-
### Tasks structure
167
-
164
+
### Tasks structure
165
+
168
166
```
169
167
├── tasks
170
168
├── config
171
169
├── register
172
170
└── pipeline.js
173
-
```
171
+
```
174
172
175
173
|File/folder|Description|
176
174
|---|---|
@@ -203,7 +201,7 @@ var tranquilpeakCssFilesToInject = [
203
201
204
202
On production environment, these javascript and stylesheets files are concatenate and minify in 1 javascript file and 1 stylesheet file and linked to their respective views
205
203
206
-
### Config tasks
204
+
### Config tasks
207
205
208
206
|Task|Description|
209
207
|---|---|
@@ -233,14 +231,14 @@ When you run `grunt build` or `grunt buildProd` tasks, a `source/assets` folder
233
231
234
232
## Build ##
235
233
236
-
### Development environment
234
+
### Development environment
237
235
238
-
1. Run `npm run start`or `grunt default`and start coding :)
236
+
1. Run `npm run start` and start coding :)
239
237
240
238
### Production environment (before deploying your blog)
241
239
242
-
1. Run `npm run prod`or `grunt buildProd`to build the project with some optimization (concat and minify) to reduce number of HTTP requests and improve performance.
240
+
1. Run `npm run prod` to build the project with some optimization (concat and minify) to reduce number of HTTP requests and improve performance.
0 commit comments