Update docs

Author: Keats

CONTRIBUTING.md

@@ -19,6 +19,6 @@ If you want to work on an issue, please mention it in a comment to avoid potenti
 any questions on how to approach it do not hesitate to ping me (@keats).
 Easy issues are tagged with `help wanted` and/or `good first issue`
 
-## Adding syntax highlighting languages and themes
+## Adding syntax highlighting languages, themes or aliases
 
 Open an issue on the [Giallo repository](https://github.com/getzola/giallo).

components/config/src/config/markup.rs

@@ -54,7 +54,6 @@ impl Highlighting {
             registry.add_theme_from_path(config_dir.join(theme))?;
         }
 
-        registry.add_plain_grammar(&["txt"])?;
         registry.link_grammars();
 
         match &self.theme {
@@ -83,7 +82,7 @@ impl Highlighting {
         self.style == HighlightStyle::Class
     }
 
-    pub fn generate_themes_css(&self) -> Vec<(String, String)> {
+    pub fn generate_themes_css(&self) -> Vec<(&'static str, String)> {
         let mut out = Vec::new();
 
         if self.style == HighlightStyle::Inline {
@@ -94,17 +93,17 @@ impl Highlighting {
         match &self.theme {
             HighlightConfig::Single { theme } => {
                 out.push((
-                    theme.clone(),
+                    "giallo.css",
                     self.registry.generate_css(theme, "z-").expect("theme to be present"),
                 ));
             }
             HighlightConfig::Dual { light_theme, dark_theme } => {
                 out.push((
-                    light_theme.clone(),
+                    "giallo-light.css",
                     self.registry.generate_css(light_theme, "z-").expect("theme to be present"),
                 ));
                 out.push((
-                    dark_theme.clone(),
+                    "giallo-dark.css",
                     self.registry.generate_css(dark_theme, "z-").expect("theme to be present"),
                 ));
             }

docs/config.toml

@@ -16,13 +16,7 @@ index_format = "elasticlunr_json"
 external_links_class = "external"
 
 [markdown.highlighting]
-theme = "github-dark"
-
-#highlight_theme = "css"
-#highlight_themes_css = [
-#  { theme = "base16-ocean-dark", filename = "syntax-theme-dark.css" },
-#  { theme = "base16-ocean-light", filename = "syntax-theme-light.css" },
-#]
+theme = "catppuccin-mocha"
 
 [link_checker]
 internal_level = "warn"

docs/content/documentation/content/linking.md

@@ -34,7 +34,7 @@ links working.
 It is possible to have Zola automatically insert anchor links next to the heading, as you can see on this documentation
 if you hover a title or covering the full heading text.
 
-This option is set in the global [`config.toml`](@/documentation/getting-started/configuration/index.md)'s `[markdown]` section and can be overridden at the section level with the `insert_anchor_links` variable on the
+This option is set in the global [`config.toml`](@/documentation/getting-started/configuration.md)'s `[markdown]` section and can be overridden at the section level with the `insert_anchor_links` variable on the
 [section front matter page](@/documentation/content/section.md#front-matter).
 
 The default template is very basic and will need CSS tweaks in your project to look decent.

docs/content/documentation/content/overview.md

@@ -69,7 +69,7 @@ By default, this page's slug will be the directory name and thus its permalink w
 ### Excluding files from assets
 
 It is possible to ignore selected asset files using the
-[ignored_content](@/documentation/getting-started/configuration/index.md) setting in the config file.
+[ignored_content](@/documentation/getting-started/configuration.md) setting in the config file.
 For example, say that you have several code files which you are linking to on your website.
 For maintainability, you want to keep your code in the same directory as the Markdown file,
 but you don't want to copy the build folders to the public web site. You can achieve this by setting `ignored_content` in the config file:

docs/content/documentation/content/search.md

@@ -19,7 +19,7 @@ implements it (using elasticlunr) to get an idea: [search.js](https://github.com
 
 ## Configuring the search index
 In some cases, the default indexing strategy is not suitable. You can customize which fields to include and whether
-to truncate the content in the [search configuration](@/documentation/getting-started/configuration/index.md).
+to truncate the content in the [search configuration](@/documentation/getting-started/configuration.md).
 
 ## Index Formats