63 lines
2.4 KiB
Markdown
63 lines
2.4 KiB
Markdown
<h1> TFGrid Docs</h1>
|
|
|
|
<h2>Table of Contents</h2>
|
|
|
|
- [Overview](#overview)
|
|
- [Basic Hero mdBook Commands](#basic-hero-mdbook-commands)
|
|
- [Install and Use Hero](#install-and-use-hero)
|
|
- [Create a New mdBook](#create-a-new-mdbook)
|
|
- [Use Hero with Docker](#use-hero-with-docker)
|
|
- [Contribute](#contribute)
|
|
|
|
## Overview
|
|
|
|
This repository contains TFGrid docs in the form of mdbooks generated with the [Hero](https://github.com/freeflowuniverse/crystallib/tree/development/cli/hero) tool.
|
|
|
|
To see the whole list of books, check the [heroscript directory](https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript).
|
|
|
|
## Basic Hero mdBook Commands
|
|
|
|
Once Hero is set on your machine, you can run the following commands to preview mdbooks on your local browser:
|
|
|
|
- Pull new changes
|
|
```
|
|
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/nameofyourbook -gp
|
|
```
|
|
|
|
- Build the book
|
|
```
|
|
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/nameofyourbook
|
|
```
|
|
- Preview on a web browser
|
|
```
|
|
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/nameofyourbook -o
|
|
```
|
|
|
|
> Note: You can use -p instead of -u and set a path to your heroscript directory, as explained in the [docs](https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/docs).
|
|
|
|
## Install and Use Hero
|
|
|
|
install hero as follows
|
|
|
|
```bash
|
|
curl https://raw.githubusercontent.com/freeflowuniverse/crystallib/development/scripts/installer_hero.sh | bash /tmp/hero_install.sh
|
|
```
|
|
|
|
you can also do it on a VM (experts only)
|
|
|
|
To install and use Hero on a full VM running on the grid, read the [full VM guide](https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/docs/hero_mdbook_fullvm.md).
|
|
|
|
## Create a New mdBook
|
|
|
|
To create a new mdbook, read the [mdbook creation guide](https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/docs/hero_create_mdbook.md).
|
|
|
|
## Use Hero with Docker
|
|
|
|
You can use Hero with Docker. Read the docs [here](https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/docs/hero_mdbook_docker.md).
|
|
|
|
## Contribute
|
|
|
|
To contribute to this repository, make a pull request of your changes.
|
|
|
|
1. Fork the repository and make a pull requests with your changes
|
|
2. If you have access, create a new branch in this repo and make a pull request with your changes |