blog

Linkita start

Start blogging in minutes with Zola and Linkita.

Screenshot of Linkita theme

Quick start

  1. On the top right of this page, click “Use this template” → “Create a new repository”
  2. Replace placeholders in content/_index.md and zola.toml
  3. Save your profile photo to static/profile.png (or change the path to your image in zola.toml)
  4. Start writing in content/blog/. See content/blog/hello.md for an example

Note: an error like Tried to build search index for language ko which is not supported, means Zola does not support search for that language. To disable search, set build_search_index = false in zola.toml

[!TIP] Take a look through zola.toml to customise further.

Local development

  1. Install Zola
  2. Clone your repository
  3. Run git submodule update --init --recursive
  4. Run zola serve
  5. Visit http://127.0.0.1:1111/

Deployment

Refer to the Zola documentation

Updating Linkita

git submodule update --remote themes/linkita

Changing the theme repository

If you prefer to use the GitHub mirror or your own fork of the theme, you can update the submodule URL:

git submodule set-url themes/linkita https://github.com/salif/linkita.git

Syntax highlighting

[!NOTE] If you are using Zola versions prior to 0.22.1, rename zola.toml to config.toml.

For Zola versions older than 0.22.0, syntax highlighting is configured directly under the [markdown] block. Replace the [markdown.highlighting] section with the following:

# Configuration of the Markdown rendering
[markdown]
# When set to "true", all code blocks are highlighted.
highlight_code = true

# When set to "true", missing highlight languages are treated as errors. Defaults to false.
error_on_missing_highlight = false

# A list of directories used to search for additional `.sublime-syntax` and `.tmTheme` files.
extra_syntaxes_and_themes = []

# The theme to use for code highlighting.
highlight_theme = "boron"