Skip to content

Documentation theme created for Hugo without dependencies

License

Notifications You must be signed in to change notification settings

zkreations/docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

67 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Hugo Docs

Docs

I made this project to easily document my own projects, but I thought it would be great to share it, so you will save the time it took me to learn everything that finally resulted in this documentation. I hope you do a lot of work!

Features

  • Optimized compatible with Core Web Vitals
  • A+ Security Level on Mozilla Observatory
  • Support for multiple languages
  • No dependencies
  • Advanced automated searcher
  • Light and dark theme
  • Shortcodes for alerts, notes, tables, etc.
  • Advanced code blocks
  • High customization

Requirements

  • Hugo 0.100.0 or higher (extended version)
  • Git - Install Git
  • Desire to document

Install

Go to the root of your Hugo project and run the following command:

git submodule add https://github.com/zkreations/docs themes/docs

Recommended structure

I made this documentation thinking that you could generate multiple versions of the same project, that's why the recommended structure should first contain a version number, for example:

content
└── 1.0
    └── index.md

If you want to start quickly, use the example I have left in the demo folder, which is the same one you are reading right now. Run the following command:

cp -R themes/docs/demo/content .

Configure

The theme contains some useful options that can help you further customize your documents. Copy the demo/config.toml file and replace the information with your data. Finally start the local server by running:

hugo serve

Contributions

Contributions are welcome, I will take time to review any request as long as you keep the following in mind when making them:

  • Do not add more options that can increase complexity.
  • Avoid JavaScript as much as possible if you can do it with CSS.
  • Do not interfere with users' custom options.

Final note

If you like this project, consider rating me with a star on github, it costs nothing and means a lot to me. You can also buy me a coffee so I can continue creating things like this.

Start documenting!

License

Docs is licensed under the MIT License