yabirgb/trueblocks-docs

To develop on this site, you need npm and hugo.

To run locally:

npm install

hugo server

We have a few customizations, but all the hard work for creating this theme was done by the good people at Doks: https://github.com/h-enk/doks/

Important directories:

The Homepage is in the layouts/index.html
Content templates go in archetypes
layouts contains all information about templates
config/_default/menus.toml contains the structure for the overall menu and the section menus

Open up config/_default/menus.toml.

If you want to add a head section, add a config to [[main]].

[[main]]   
  name = "Docs"
  url = "/docs/prologue/introduction/"
  weight = 10

The more "weight", the farther to the left it will be.

Then change some files in layouts. Check out the files the template owner changed here. atwriter/new_doks_site#1

If you want to add a subsection, it will look like this under [[<section-name>]]

[[docs]]
  name = "Tools"
  weight = 20
  identifier = "tools"
  url = "/docs/concepts/"

The more weight it has, the farther down the section will be.

When you create content, you probably want to create corresponding directories in content.

We love contributors. Please see information about our work flow before proceeding.

Fork this repository into your own repo.
Create a branch: git checkout -b <branch_name>.
Make changes to your local branch and commit them to your forked repo: git commit -m '<commit_message>'
Push back to the original branch: git push origin TrueBlocks/trueblocks-core
Create the pull request.

Thanks to the following people who have contributed to this project:

If you have questions, comments, or complaints, please join the discussion on our discord server which is linked from our website.