mirror of
https://github.com/ivabus/www
synced 2024-11-10 05:25:14 +03:00
README tidy
This commit is contained in:
parent
b3d7689011
commit
36664f4f6c
81
README.md
81
README.md
|
@ -1,64 +1,65 @@
|
|||
# tea/www
|
||||
![tea](https://tea.xyz/banner.png)
|
||||
|
||||
Deploys to [tea.xyz](https://tea.xyz).
|
||||
|
||||
|
||||
# Conditions of Use
|
||||
|
||||
This repo is open source, but you may not publish this website in an attempt
|
||||
to masquerade as tea.inc. Trademark law has our back here.
|
||||
|
||||
|
||||
# Getting Started
|
||||
|
||||
```sh
|
||||
sh <(curl tea.xyz) https://github.com/teaxyz/www
|
||||
```
|
||||
|
||||
Alternatively:
|
||||
|
||||
```sh
|
||||
hugo serve --watch -D
|
||||
```
|
||||
|
||||
|
||||
# Editing/Syntax
|
||||
|
||||
This site is has been built with the help of [Bootstrap] for CSS/JS heavy-lifting and [HUGO] for templating and DRY development. HUGO must be installed locally in order to adequately preview development via terminal command `hugo server`. Partials/repeated components can be be found in [`layouts/partials`]. Each HTML page ([`layouts/page`]) must have a corresponding Markdown file in the [`content`] folder.
|
||||
|
||||
# Creating a New Page
|
||||
|
||||
1. Create a new HTML file in [`layouts/page`].
|
||||
2. Define the content section via `{{ define "main" }}` prior to proposed content area, and `{{ end }}` after proposed content area. User this HTML file to affect layout and styling. Content may be added via the corresponding `.md` file (see step 3)
|
||||
3. Create an `.md` file in the [`content`] folder and provide the appropriate metadata. For example:
|
||||
```yaml
|
||||
title: "White Paper" # (How this page will appear in the menu)
|
||||
Description: "tea.white paper" # (Populates as page title)
|
||||
layout: "white-paper" # (the associated HTML file)
|
||||
menu: main # (Assign a menu)
|
||||
weight: 7 # (Order in which this item will appear)
|
||||
```
|
||||
Following that, begin typing content. This will populate in the section of your HTML document that has been defined as `main`.
|
||||
4. If adding a menu link for an external source or ID, edit the [`config.toml`](config.toml) accordingly.
|
||||
5. Run with `hugo serve --watch -D`.
|
||||
|
||||
|
||||
# Editing Partials/Repeated Components
|
||||
|
||||
Partials may be edited in plain HTML. No additional [HUGO] syntax is required.
|
||||
|
||||
|
||||
# Defining Partial Locations
|
||||
|
||||
Partials are defined via the `baseof.html` file in [`layouts/default`]. This informs the layout of a newly generated page. Insert new partials via the syntax `{{- partial "partial.html" -}}`.
|
||||
|
||||
|
||||
# Dependencies
|
||||
|
||||
| Project | Version |
|
||||
|------------|---------|
|
||||
| nodejs.org | ^18 |
|
||||
|------------|---------|
|
||||
| gohugo.io | ^0.99 |
|
||||
|------------|---------|
|
||||
| bootstrap | ^5 |
|
||||
|------------|---------|
|
||||
| jquery | ^3.6 |
|
||||
|
||||
|
||||
# Editing/Syntax
|
||||
|
||||
This site is has been built with the help of [Bootstrap](https://getbootstrap.com/docs/5.2/getting-started/introduction/) for CSS/JS heavy-lifting and [HUGO](https://gohugo.io/documentation/) for templating and DRY development. HUGO must be installed locally in order to adequately preview development via terminal command [hugo server]. Partials/repeated components can be be found in layouts/partials. Each HTML page (layouts/page) must have a corresponding Markdown file in the Content folder (content/).
|
||||
|
||||
# Creating a New Page
|
||||
|
||||
1. Create a new HTML file in layouts/page
|
||||
2. Define the content section via `{{ define "main" }}` prior to proposed content area, and {{ end }} after proposed content area. User this HTML file to affect layout and styling. Content may be added via the corresponding .md file (see step 3)
|
||||
3. Create an `.md` file in the 'Content' folder and provide the appropriate metadata. Example:
|
||||
|
||||
```yaml
|
||||
title: "White Paper" # (How this page will appear in the menu)
|
||||
Description: "tea.white paper" # (Populates as page title)
|
||||
layout: "white-paper" # (the associated HTML file)
|
||||
menu: main # (Assign a menu)
|
||||
weight: 7 # (Order in which this item will appear)
|
||||
```
|
||||
|
||||
Following that, begin typing content. This will populate in the section of your HTML document that has been defined as `main`.
|
||||
|
||||
4. If adding a menu link for an external source or ID, edit the config.toml accordingly.
|
||||
5. Run with `hugo serve --watch -D`.
|
||||
|
||||
# Editing Partials/Repeated components
|
||||
|
||||
Partials may be edited in plain HTML. No additional HUGO syntax is required.
|
||||
|
||||
# Defining Partial Locations
|
||||
|
||||
Partials are defined via the `baseof.html` file in `layouts/default`. This informs the layout of a newly generated page. Insert new partials via the syntax `{{- partial "partial.html" -}}`.
|
||||
[Bootstrap]: https://getbootstrap.com/docs/5.2/getting-started/introduction/
|
||||
[HUGO]: https://gohugo.io/documentation/
|
||||
[`content`]: content/
|
||||
[`layouts/page`]: layouts/page/
|
||||
[`layouts/partials`]: layouts/partials/
|
||||
[`layouts/default`]: layouts/default/
|
||||
|
|
Loading…
Reference in a new issue