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.

configuration.md 5.3KB

7 years ago
7 years ago
6 years ago
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132
  1. +++
  2. title = "Configuration"
  3. weight = 4
  4. +++
  5. The default configuration will be enough to get Zola running locally but not more than that.
  6. It follows the philosophy of only paying for what you need: almost everything is turned off by default.
  7. To change the config, edit the `config.toml` file.
  8. If you are not familiar with TOML, have a look at [the TOML Spec](https://github.com/toml-lang/toml)
  9. to learn about it.
  10. Only one variable - `base_url` - is mandatory, everything else is optional. You can find all variables
  11. used by Zola config as well as their default values below:
  12. ```toml
  13. # Base URL of the site, the only required config argument
  14. base_url = "mywebsite.com"
  15. # Used in RSS by default
  16. title = ""
  17. description = ""
  18. # The default language, used in RSS
  19. default_language = "en"
  20. # Theme name to use
  21. theme = ""
  22. # Highlight all code blocks found
  23. highlight_code = false
  24. # Which theme to use for the code highlighting.
  25. # See below for list of accepted values
  26. highlight_theme = "base16-ocean-dark"
  27. # Whether to generate a RSS feed automatically
  28. generate_rss = false
  29. # The number of articles to include in the RSS feed. Will include all items if
  30. # not set (the default).
  31. # rss_limit = 20
  32. # The taxonomies to be rendered for that site and their configuration
  33. # Example:
  34. # taxonomies = [
  35. # {name = "tags", rss = true}, # each tag will have its own RSS feed
  36. # {name = "categories", paginate_by = 5}, # 5 items per page for a term
  37. # {name = "authors"}, # Basic definition: no RSS or pagination
  38. # ]
  39. #
  40. taxonomies = []
  41. # The additional languages for that site
  42. # Example:
  43. # languages = [
  44. # {code = "fr", rss = true}, # there will be a RSS feed for French content
  45. # {code = "it"}, # there won't be a RSS feed for Italian content
  46. # ]
  47. #
  48. languages = []
  49. # Whether to compile the Sass files found in the `sass` directory
  50. compile_sass = false
  51. # Whether to build a search index out of the pages and section
  52. # content for the `default_language`
  53. build_search_index = false
  54. # Go through every links in all content and check if the links are valid
  55. # If a link is invalid (404, 500, etc), the build will error.
  56. # Link checking can take a very long time if you have many links so this should
  57. # only enabled once in a while to catch any dead links.
  58. check_external_links = false
  59. # A list of glob patterns specifying asset files to ignore when
  60. # processing the content directory.
  61. # Defaults to none, which means all asset files are copied over to the public folder.
  62. # Example:
  63. # ignored_content = ["*.{graphml,xlsx}", "temp.*"]
  64. ignored_content = []
  65. # A list of directories to search for additional `.sublime-syntax` files in.
  66. extra_syntaxes = []
  67. # Optional translation object. The key if present should be a language code
  68. [translations]
  69. # You can put any kind of data in there and it
  70. # will be accessible in all templates
  71. [extra]
  72. ```
  73. ## Syntax highlighting
  74. Zola currently has the following highlight themes available:
  75. - [1337](https://tmtheme-editor.herokuapp.com/#!/editor/theme/1337)
  76. - [agola-dark](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Agola%20Dark)
  77. - [ascetic-white](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Ascetic%20White)
  78. - [axar](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Axar)
  79. - base16-ocean-dark
  80. - base16-ocean-light
  81. - [bbedit](https://tmtheme-editor.herokuapp.com/#!/editor/theme/BBEdit)
  82. - [boron](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Boron)
  83. - [charcoal](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Charcoal)
  84. - [cheerfully-light](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Cheerfully%20Light)
  85. - [classic-modified](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Classic%20Modified)
  86. - [demain](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Demain)
  87. - [dimmed-fluid](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Dimmed%20Fluid)
  88. - [dracula](https://draculatheme.com/)
  89. - [gray-matter-dark](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Gray%20Matter%20Dark)
  90. - [gruvbox-dark](https://github.com/morhetz/gruvbox)
  91. - [gruvbox-light](https://github.com/morhetz/gruvbox)
  92. - [idle](https://tmtheme-editor.herokuapp.com/#!/editor/theme/IDLE)
  93. - [inspired-github](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Inspiredgithub)
  94. - [ir-white](https://tmtheme-editor.herokuapp.com/#!/editor/theme/IR_White)
  95. - [kronuz](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Kronuz)
  96. - [material-dark](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Material%20Dark)
  97. - [material-light](https://github.com/morhetz/gruvbox)
  98. - [monokai](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Monokai)
  99. - [solarized-dark](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Solarized%20(dark))
  100. - [solarized-light](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Solarized%20(light))
  101. - [subway-madrid](https://github.com/idleberg/Subway.tmTheme)
  102. - [subway-moscow](https://github.com/idleberg/Subway.tmTheme)
  103. - [visual-studio-dark](https://tmtheme-editor.herokuapp.com/#!/editor/theme/Visual%20Studio%20Dark)
  104. - [ayu-light](https://github.com/dempfi/ayu)
  105. - [ayu-dark](https://github.com/dempfi/ayu)
  106. - [ayu-mirage](https://github.com/dempfi/ayu)
  107. Zola uses the Sublime Text themes, making it very easy to add more.
  108. If you want a theme not on that list, please open an issue or a pull request on the [Zola repo](https://github.com/getzola/zola).