Skip to content

Latest commit

 

History

History
35 lines (24 loc) · 1.5 KB

README.md

File metadata and controls

35 lines (24 loc) · 1.5 KB

devcodeabode.github.io

The Dev Code Abode's Github Pages

To Install Hugo:

Follow the instructions on the Hugo Website. You will need the "Extended" version if an option exists.

To Clone with Theme:

git clone --recurse-submodules https://github.com/devcodeabode/devcodeabode.github.io.git

Note About hugo commands

All hugo commands should be run from within the devcodeabode folder

To Start Development Server:

  • Without drafts: hugo server --disableFastRender
  • With drafts (drafts are not rendered on production): hugo server --disableFastRender -D

Follow the link in the terminal output. This is a live server, so making changes to the site will rebuild it in real time.

To add content:

hugo new path/to/title.md

Hugo will try and figure out the content type based on the path. If you are adding to a changelog or documentation, you must explicitly set the type in your command!

For your convenience, here are some sample commands:

  • Posts: hugo new posts/title.md
  • Documentation: hugo new -k docs modibo/docs/manual-pages/plugin-name.md
  • Changelog: hugo new -k changelog modibo/changelog/year/mm-dd.md
  • Redirect Links: hugo new links/title.md

Notes About Building

  • Do not build the site. It's not necessary. Github Actions will build it fresh from the source code.
  • Pull Requests must build against the latest Hugo version to be able to be merged.
  • The default build directory, devcodeabode/public, is .gitignored