www/README.md
neil 26cea2aedd - render dynamic content on package details page ie: /packages/cmake
- automatically create /packages/[packageName].md on /src/content/packages/*
2022-10-14 09:46:45 +08:00

55 lines
1.3 KiB
Markdown

![tea](https://tea.xyz/banner.png)
Deploys to [tea.xyz].
# Legal
You may not publish this website in an attempt to masquerade as tea.inc.
The tea logo and wordmark are registered trademarks of tea.inc.
# Contributing
* The site is built with [Hugo] and [Bootstrap].
* `.html` files in [`./src/layouts/page/`] have a corresponding `.md` file in [`./src/content/`].
* Repeated components are in [`./src/layouts/partials/`].
## Getting Started
Just once assuming there are no updates in `/src/data/packages.json`. This will create the package detail pages.
```sh
.github/build-package-pages.sh src/data/packages.json src/content/packages
```
hugo can render your edits while you work:
```sh
hugo serve --watch --buildDrafts --source src
```
## Dependencies
Install hugo yourself or use tea: `sh <(curl tea.xyz) hugo`.
| Project | Version |
|------------|---------|
| gohugo.io | >=0.99 |
# Build
Builds a static, deployable version of the website.
```sh
.github/build-package-pages.sh src/data/packages.json src/content/packages
hugo --source src --destination ../public --minify
```
[tea.xyz]: https://tea.xyz
[Bootstrap]: https://getbootstrap.com/docs/5.2/getting-started/introduction/
[Hugo]: https://gohugo.io/documentation/
[`./src/layouts/page/`]: src/layouts/page
[`./src/content/`]: src/content
[`./src/layouts/partials/`]: src/layouts/partials