dev_docs #154

Merged
mik-tf merged 2 commits from dev_docs into development 2024-10-23 03:51:36 +00:00
2 changed files with 19 additions and 11 deletions

View File

@ -16,7 +16,7 @@ You can then use a code editor, e.g. VSCodium, to change the files locally and u
## Prerequisites
- [Docker engine](https://docs.docker.com/engine/install/ubuntu/) should be installed and running on Linux
- [Docker Engine](https://docs.docker.com/engine/install/ubuntu/) should be installed and running on Linux
- [Docker Desktop](https://www.docker.com/products/docker-desktop/) should be installed and running on MacOS and Windows
- You need a git repository to work with (here we use **info_tfgrid**)
- Clone the hero mdbook repo on your local machine (i.e. the host) and note the path
@ -31,9 +31,15 @@ Once you've set Hero Docker, you can adjust the files at the host path in a code
Note that you will need to adjust the local path of the git repo and the docker path of the git repo.
- On a terminal window, start Hero docker
- On a terminal window, create the code repository on the local machine
```
sudo docker run --name herodocker -d -v /local/machine/path/to/git/repo:/docker/path/to/git/repo/ ghcr.io/scottyeager/hero:latest
mkdir -p ~/code/git.ourworld.tf/tfgrid
cd ~/code/git.ourworld.tf/tfgrid
git clone https://git.ourworld.tf/tfgrid/info_tfgrid
```
- Start Hero docker
```
sudo docker run --net=host --name herodocker -d -v ~/code/git.ourworld.tf/tfgrid:~/code/git.ourworld.tf/tfgrid ghcr.io/scottyeager/hero:latest
```
- In our case, the docker path to the repo is the following
```
@ -43,24 +49,28 @@ Note that you will need to adjust the local path of the git repo and the docker
```
sudo docker exec -it herodocker bash
```
- Change directory
```
cd ~/code/git.ourworld.tf/tfgrid/info_tfgrid
```
- Git configuration
- Set git lobally with a safe directory
```
git config --global --add safe.directory /root/code/git.ourworld.tf/tfgrid/info_tfgrid
```
- You can now use Hero normally, e.g. with **projectinca**
- You can now use Hero normally, e.g. with **tech**
- With a URL:
```
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/projectinca
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/tech
```
- With a path:
```
hero mdbook -p /root/code/git.ourworld.tf/tfgrid/info_tfgrid/heroscript/projectinca
hero mdbook -p /root/code/git.ourworld.tf/tfgrid/info_tfgrid/heroscript/tech
```
- In this case, you can modify the mdbook on the local machine's git repo that you set in the prerequisites section and the changes will be shown on the docker path
- To view the mdbook on your local browser, run the lines:
```
cd ~/hero/var/mdbuild/projectinca/
cd ~/hero/var/mdbuild/tech/
mdbook serve -n 0.0.0.0
```
- You should be able to view the rendered book at

View File

@ -80,7 +80,5 @@ choco install mdbook
- Update an mdbook on a GitHub repo
- https://manual.grid.tf/knowledge_base/collaboration/contribute.html
- Deploy a Hero Mdbook on Docker
- https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/development/docs/hero_mdbook_docker.md
- Create a Hero Mdbook
- https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/development/docs/hero_create_mdbook.md
- [Deploy a Hero Mdbook on Docker](./hero_mdbook_docker.md)
- [Create a Hero Mdbook](./hero_create_mdbook.md)