jk.nipponalba.scot website https://jk.nipponalba.scot
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This repo is archived. You can view files and clone it, but cannot push or open issues/pull-requests.

102 lines
3.3 KiB

5 years ago
  1. # Anatole ![](https://img.shields.io/badge/license-MIT-blue.svg) [![Netlify Status](https://api.netlify.com/api/v1/badges/ee7a5df4-b944-4e03-853d-39219c96d484/deploy-status)](https://alexbilz.com/)
  2. Anatole is a beautiful minimalist two-column [hugo](https://gohugo.io/) theme based on farbox-theme-Anatole.
  3. ![Screenshot Anatole Theme](https://raw.githubusercontent.com/lxndrblz/anatole/master/images/screenshot.png)
  4. ## Features
  5. Anatole's aims to be minimalistic and sleek, but still brings some great functionality.
  6. Features include:
  7. * Profile picture and slogan
  8. * Navigation items
  9. * Google Analytics
  10. * Comments powered by Disqus
  11. * Katex support
  12. * MIT License
  13. * Fontawesome icons
  14. ## Preview the exampleSite
  15. ```
  16. git clone https://github.com/lxndrblz/anatole.git anatole
  17. cd anatole/exampleSite
  18. hugo server --themesDir ../..
  19. ```
  20. ## Quick Start
  21. 1. Add the repository into your Hugo Project repository as a submodule: `git submodule add https://github.com/lxndrblz/anatole.git themes/anatole`.
  22. 2. Configure your `config.toml`. Feel free to copy the demo `config.toml` and some content from the exampleSite.
  23. 3. Build your site with `hugo serve` and admire the result at `http://localhost:1313/`.
  24. ## Update your installation
  25. If you want to get the latest update of the `Anatole` theme please execute this command:
  26. ```
  27. git submodule update --remote --merge
  28. ```
  29. ## Modifying the config.toml
  30. Ìn this section I'll discuss the custom parameters available within the `config.toml`. The complete [sample](https://github.com/lxndrblz/anatole/blob/master/exampleSite/config.toml) can be found in the exampleSite folder.
  31. ### Profile picture and slogan
  32. ```
  33. [params]
  34. title = "I'm Jane Doe"
  35. author = "Jane Doe"
  36. description = "Call me Jane"
  37. profilePicture = "images/profile.jpg"
  38. ```
  39. ### Navigation items
  40. Non-content entries can be added right from the `config.toml` file.
  41. ```
  42. [menu]
  43. [[menu.main]]
  44. name = "Home"
  45. identifier = "home"
  46. weight = 100
  47. url = "/"
  48. [[menu.main]]
  49. name = "Posts"
  50. weight = 200
  51. identifier = "posts"
  52. url = "/post/"
  53. ```
  54. If you want to add content to menus, please see the `about.md` file as an example.
  55. ```
  56. menu: main
  57. name: "About"
  58. weight: 300
  59. ```
  60. ### Comments powered by Disqus
  61. No comment section is shown on the `single.html`, unless a disqus code is specified in the `config.toml` file.
  62. ```
  63. disqusShortname = "XXX"
  64. ```
  65. ### Google Analytics
  66. To use Google Analytics, a valid tracking code has to be added. If you don't want to load the code, then commend out the parameter.
  67. ```
  68. googleAnalytics = "UA-123-45"
  69. ```
  70. ### Beautiful math functions
  71. ```
  72. ## Math settings
  73. [params.math]
  74. enable = false # options: true, false. Enable math support globally, default: false. You can always enable math on per page.
  75. use = "katex" # options: "katex", "mathjax". default is "katex".
  76. ```
  77. ## License
  78. Anatole is licensed under the [MIT license](https://github.com/lxndrblz/anatole/blob/master/LICENSE).
  79. ## Maintenance
  80. This theme is maintained by its author [Alexander Bilz](https://github.com/lxndrblz). Please open an issue/pull request if you want to contribute in making this theme better and more feature-complete.
  81. ## Special Thanks 🎁
  82. * Go to [Cai Cai](https://github.com/hi-caicai), for the great Anatole Farbox theme that formed the foundation for this theme.
  83. * Go to [Kareya Saleh](https://unsplash.com/photos/tLKOj6cNwe0) for providing the profile picture in the exampleSite.