FoHuW is a Hugo theme inspired by Docsy using Fomantic-UI. It is for technical documentation sets, sites requiring structured navigation, showcase features, embedded apps, and more. Release information is in data/releases.yaml
This theme was started as a fork of Docsy and then changed to allow less technical, lazier writers to guess at syntax is actively being maintained.
The goal is to have a self documenting set of shortcodes that can be guessed.
Fork the repo. Either install clog or use the bash snippets in
clogrc/clog.config.yaml. The following manual command should also work in
a linux shell (bash, zsh, sh on linux mac or windows WSL)
# make a symbolic link to the example site
ln -s documentation/content content
# run the hugo server
hugo server --port=1313 --buildDrafts --buildFuture --buildExpired --cleanDestinationDir
# delete the symbolic link
rm contentThe following are basic prerequisites for using Docsy in your site:
-
Install a recent release of the Hugo "extended" version. If you install from the Hugo release page, make sure you download the
_extendedversion which supports SCSS. -
Install
PostCSSso that the site build can create the final CSS assets. You can install it locally by running the following commands from the root directory of your project:npm install --save-dev autoprefixer npm install --save-dev postcss-cli
Starting in version 8 of
postcss-cli, you must also separately installpostcss:npm install -D postcss
Any additional prerequisites depend on the installation option
you choose. We recommend using Docsy as a Hugo module, which requires that
you have the go language installed in addition to Hugo and PostCSS.
For complete prerequisites and instructions, see our Get started guides.