- SCSS 58.3%
- HTML 35.8%
- JavaScript 3.9%
- Makefile 2%
Dialectical Library
Getting Started
Command-Line Utilities
First, you need a relatively recent version of Hugo installed. (At time of writing, I have
v0.144.2)
Follow the installation instructions for your platform of choice. On Linux I would
recommend against Snap, using Homebrew or go install are probably best.
Also required: git and make.
Project Bootstrap
Run make deps to initialize git submodules. They are:
.
├── public # points to dialab/pages repo
└── themes
└── diary # base theme of the site
Adding A New Review
hugo new content reviews/cool-book.md
This will create content/reviews/cool-book.md based on the archetypes/reviews.md template.
Run a local server to see your changes with make server.
Notes on Typography
The Typographer plugin will translate certain character(s) into HTML entities automatically.
| Markdown | Replacement | Description |
|---|---|---|
... |
… |
Horizontal ellipsis |
' |
’ |
apostrophe |
-- |
– |
en dash |
--- |
— |
em dash |
" |
“ |
left double quote |
" |
” |
right double quote |
' |
‘ |
left single quote |
' |
’ |
right single quote |
This means you should take care to use only standard single- and double-quotes.
Footnotes
The Goldmark renderer will automatically generate footnotes with the [^1] syntax. The floating footnotes depend on its
markup, so ensure that you write your footnotes that way.
Deployment
We don't (yet) have automated deploys, so for the time being you run:
make commit
make deploy