doc theme

2017-09-08 19:13:41 -07:00
parent f2a9f8a938
commit cb861e72a9
300 changed files with 38823 additions and 0 deletions
@@ -0,0 +1,40 @@
+++
+title = "Customize website look and feel"
+Weight=3
+++
+
+You can change the style and behavior of the theme without touching it.
+
+* inject your own html,  css or js into the page
+* overide existing css or js with your own files
+
+## Inject your HTML
+
+### into the \<head\> part of each page :
+
+Create a `custom-head.html` into a `layouts/partials` folder next to the content folder
+
+> * content/
+> * layouts/
+>   * partials/
+>      * custom-head.html
+
+now feel free to add the JS, CSS, HTML code you want :)
+
+### at the end of the body part of each page :
+
+Create a `custom-footer.html` into a `layouts/partials` folder next to the content folder
+
+> * content/
+> * layouts/
+>   * partials/
+>      * custom-footer.html
+
+now feel free to add the JS, CSS, HTML code you want :)
+
+## overide existing CSS or JS
+
+Create the matching file in your static folder, hugo will use yours instead of the theme's one.
+Example : 
+
+create a theme.css and place it into `static/css/` to fully overide docdock's theme.css
@@ -0,0 +1,35 @@
+++
+title = "Theme variants"
+description = "change theme style/colors"
+++
+
+In site configuration file, you can set a variant name of this theme to load a specific css, with different color specifications.
+
+add a param `themeVariant = "VARIANT_NAME"` in the `[params]` part of config.toml file.
+
+{{%info%}}Available variants change only colors at this moment{{%/info%}}
+
+
+## Variant "gray"
+```
+[params]
+themeVariant = "gray"
+```
+
+![green docdock](/variant-gray.png)
+
+## Variant "gold"
+```
+[params]
+themeVariant = "gold"
+```
+
+![gold docdock](/variant-gold.png)
+
+## Variant "green"
+```
+[params]
+themeVariant = "green"`
+```
+
+![green docdock](/variant-green.png)