compose-theme/README.md

51 lines
1.8 KiB
Markdown
Raw Normal View History

2024-07-26 17:08:59 +02:00
# Compose
Compose is a [Hugo](https://gohugo.io/) theme for documentation websites. The theme provides a simple navigation & structure.
![Hugo Compose Theme](https://raw.githubusercontent.com/onweru/compose/master/images/tn.png)
## Features
1. Documentation
2. Gallery Support
3. Native lazy loading of images
4. Live search
5. Flowcharts, Piecharts, doughnut & bar charts support
6. Searchable & Sortable tables
7. Syntax highlighting
8. Mermaid Support
## Documentation
- [Install Compose theme](https://composedocs.netlify.app/docs/compose/install-theme/)
- [Use Tina CMS](https://composedocs.netlify.app/docs/compose/use-tina-cms/)
- [Customize your site](https://composedocs.netlify.app/docs/compose/customize/)
- [Configure search](https://composedocs.netlify.app/docs/compose/search/)
- [Shortcodes](https://composedocs.netlify.app/docs/compose/shortcodes/)
- [Mermaid](https://composedocs.netlify.app/docs/compose/mermaid/)
## ExampleSite
The [exampleSite](https://github.com/onweru/compose/tree/master/exampleSite) serves as this theme's [user guide](https://composedocs.netlify.app/docs/compose/install-theme/) .
This guide covers the necessary bits. As the project evolves, the user-guide will get more comprehensive
You can use Hugo to generate and serve a local copy of the guide (also useful for testing local theme changes).
```
git clone --recurse-submodules --depth 1 https://github.com/onweru/compose.git
cd compose/exampleSite/
hugo server --themesDir ../..
```
### Also built by Weru
1. [Clarity Theme](https://github.com/chipzoller/hugo-clarity)
2. [Newsroom Theme](https://github.com/onweru/newsroom)
3. [Swift Theme](https://github.com/onweru/hugo-swift-theme)
4. [Browse Theme](https://github.com/onweru/browse)
## License
This theme is available under the [MIT license](https://github.com/onweru/compose/blob/master/LICENSE).