pico

Clean and minimalistic dark theme

Author: Vitaliy Kuznetsov

License: MIT

Homepage: https://github.com/kuznetsov17/pico

Live Demo: https://kuznetsov17.github.io/pico/

Last updated: 2024-11-18T05:58:26Z

Configuration

General

I am not the best webmaster, but should be somewhat responsive. I intentionally using the bigger fonts to make, feel free to change it in main.css

Light mode

Now light mode also supported.

Important

Please make sure to set up your base_url with trailing slash:

base_url = "https://kuznetsov17.github.io/pico/"

Comments

Theme supports Giscuss for comments. The configuration is done via config.toml. Here you can see the example section used for this page deployment:

[extra.giscus]
data_repo="kuznetsov17/pico"
data_repo_id="R_kgDOLIfXYA"
data_category="General"
data_category_id="DIC_kwDOLIfXYM4Ccn56"
data_mapping="title"
data_strict="0"
data_reactions_enabled="0"
data_emit_metadata="0"
data_input_position="top"
data_theme="//kuznetsov17.github.io/pico/css/gs_dark.css"
data_lang="en"
crossorigin="anonymous"
nonce=""

Page configurations

Customize the page blocks by setting configuration in [extra] section:

show_copyright = true / false # enables / disables footer with copyright
show_comments = true / false # enables / disables comments
show_shares = true / false # enables / disables section with social share buttons
show_toc = true / false # enables / disable TOC
show_date = true / false # displays publication date in page

Blog

I am using this theme for my notes, or probably blog. The section template supports pagination, tags, sorts the pages by publication date. You may see the working example here

Search

The theme supports the search using elasticrunrjs. To enable the search, you will need the following configuration in config.toml:

build_search_index = true

[search]
index_format = "elasticlunr_json"

config.toml extras

author = "John Doe" # author. Will be puth in page metadata
description = "Some description, if you somehow didn't set it in page / section settings"
logo_src = "images/logo.svg" # logo src
avatar_src = "images/avatar.png" # avatar src
index_page="index" # name of the index page. Should be one of top_menu to make things work
top_menu = ["index","features","notes"] # Menu items
copyright_string = "Сreated by John Doe in 2024 – %YEAR% for fun." # footer content. %YEAR% will be replaced with current year
nonce = "${SOME_HASH_VALUE}" # used for JavaScript src nonce

timeline

{% timeline() %}
[{
    "title":"Lorem Ipsum Event",
    "body":"Lorem Ipsum is simply dummy text of the printing and typesetting industry.",
    "date":"Jul-2023"
},
{
    "title":"Lorem Ipsum event 2",
    "body":"Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged.",
    "date":"Jun-2022"
}]
{% end %}

Callouts

{% callout(type = 'warning') %}
This is an example of **Warning** callout. [Some link](#)
{% end %}
{% callout(type = 'alert') %}
This is an example of **Alert** callout. [Some link](#)
{% end %}
{% callout(type = 'info') %}
This is an example of **Info** callout. [Some link](#)
{% end %}

Mermaid

Read more on how to use mermaid in their documentation

{% mermaid() %}
gitGraph
       commit
       commit
       branch develop
       checkout develop
       commit
       commit
       checkout main
       merge develop
       commit
       commit
{% end %}

{% mermaid() %}
graph LR
    A[Square Rect] -- Link text --> B((Circle))
    A --> C(Round Rect)
    B --> D{Rhombus}
    C --> D
{% end %}

Thanks to

Screenshot

Screenshot