Red-Lang.org

This is the site source.

Building the site

1. Install Node 8+ (I recommend using nvm or nvm-windows)
2. Install Hugo - You can test that it's working by running hugo after the executable is available in your $PATH. If run from just any old directory, it should complain "unable to locate config file," which means it's working.
3. Install Yarn
4. Clone this repository
   • If you are using HTTPS (not SSH), you'll need to update the submodule reference in your clone to the theme directory to HTTPS as well. See this answer.
5. Run git submodule update --init --recursive to initialize the theme submodule after cloning.
6. Go to the directory where you cloned this repo and run yarn install to install dependencies
7. Run yarn start
8. Visit http://localhost:1313

To build for production, run yarn build. The rendered site will be in the public/ dir.

If you are using Ubuntu, you can use this script that will download and install everything you need. This has been tested with fresh install of Ubuntu server 19.10.

See other scripts in package.json.

Recommended dev environment

VS Code (this will use the workspace settings defined in .vscode/settings.json) with ESLint, Prettier, and stylelint extensions installed. Linting and formatting will automatically run with a git hook, but these give you faster feedback.

Working with the theme git submodule

To pull in submodule changes:

$ git submodule update --remote --merge
$ git commit -a -m "submodule updated"

To push changes made in theme submodule (while within themes/featherweight directory):

$ git commit -a -m "updates"
$ git push origin HEAD:<branch-name-in-theme-repo>

Useful things

Embed Responsively will give you YouTube/Vimeo embed codes that work responsively (see 1up-media.html template partial for example).

Photos are not automatically resized when added through Netlify CMS, so resize/crush them before uploading.

Getting familiar with Go templates is very handy for working with Hugo. Here's a good tutorial.

Pretty printing Hugo variables for debug: https://gist.github.com/kaushalmodi/afb6c3e5098eccc028bddc91cf1eb53a

Find the right syntax for your YAML multiline strings - https://yaml-multiline.info/