d3c3nt

[DORMANT] a fairly decent theme for the zola static site engine
git clone git://git.figbert.com/d3c3nt.git
Log | Files | Refs | README | LICENSE

config.md (1638B)


      1 +++
      2 title = "Docs"
      3 +++
      4 
      5 # Configuration
      6 
      7 d3c3nt has a number of custom variables you can set in the `[extra]`
      8 section of your `config.toml` file to personalize the theme for your
      9 site.
     10 
     11 ## Navbar
     12 
     13 To customize the navbar, add a `d3_nav` property. The variable should be
     14 an array of objects, which each have a `name` and `path` value. `name`
     15 will be used as the link's text, and `path` will be used as the `href`
     16 value.
     17 
     18 ### Example
     19 ```toml
     20 d3_nav = [
     21   { name = "HOME", path = "/" },
     22   { name = "POSTS", path = "/posts/" }
     23 ]
     24 ```
     25 ### Output
     26 ```html
     27 <nav>
     28   <a href="/">HOME</a>
     29   <a href="/posts/">POSTS</a>
     30 </nav>
     31 ```
     32 
     33 ## Favicon
     34 
     35 To customize the favicon, set the `d3_icon` property. The variable
     36 should be a string path to an image in the static directory.
     37 
     38 ### Example
     39 ```toml
     40 d3_icon = "/icon.png"
     41 ```
     42 ### Output
     43 ```html
     44 <link rel="icon" href="/icon.png">
     45 ```
     46 
     47 ## Metadata
     48 
     49 d3c3nt provides two variables one can set to assert authorship and
     50 enhance SEO: `d3_author` and `d3_twitter`. `d3_author` should be set to
     51 your name/handle, and is used in the subheading of posts on your site.
     52 `d3_twitter` should be set to your Twitter username (not including the
     53 "@" symbol), and will be used to set meta tags used by Twitter for site
     54 previews.
     55 
     56 ### Example
     57 ```toml
     58 d3_author = "FIGBERT"
     59 d3_twitter = "therealFIGBERT"
     60 ```
     61 ### Output
     62 ```html
     63 <meta name="twitter:card" content="summary">
     64 <meta name="twitter:creator" content="@therealFIGBERT">
     65 <!-- ... -->
     66 <small>
     67   <time datetime="2021-12-23">December 23, 2021</time>
     68   by <a href="https://figbert.com/">FIGBERT</a>
     69 </small>
     70 ```
     71 
     72 [realfavicongenerator.net]: https://realfavicongenerator.net/