info_tfgrid

mdbook

Go to file

mik-tf dac4534d99 Update docs/hero_mdbook_fullvm.md added line to install cargo		2024-02-22 15:05:49 +00:00
books	...	2024-02-21 12:16:09 +03:00
collections	...	2024-02-21 12:16:09 +03:00
docs	Update docs/hero_mdbook_fullvm.md	2024-02-22 15:05:49 +00:00
heroscript	dd	2024-02-20 14:03:57 +03:00
scripts	Update scripts/hero_mdbook.sh	2024-02-22 15:04:48 +00:00
specs	...	2024-01-27 08:38:38 +03:00
.gitignore	...	2024-01-26 06:06:57 +03:00
LICENSE	...	2024-01-26 06:06:57 +03:00
README.md	Update README.md	2024-02-16 13:34:47 +00:00
sshkey.md	...	2024-02-05 12:51:02 +03:00
sync_production.sh	...	2024-02-21 12:16:09 +03:00

README.md

https://info.ourworld.tf/duniayetu

First install hero:

# Download the hero installer script
curl https://raw.githubusercontent.com/freeflowuniverse/crystallib/development/scripts/installer_hero.sh > /tmp/hero_install.sh
# Run the script as root to properly complete the script (e.g. sudo bash ...)
bash /tmp/hero_install.sh
# Check how to use, can also do on each of the subcommands
hero -help
# If it can't find hero, do the following on osx
source ~/.zprofile

There is also a quick guide and a script on setting mdbook and hero on a full VM running on the TFGrid. Read the docs for more information.

to run the book

hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript

# In case you want to open the generated book and edit
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript -e

troubleshoot

for Ubuntu, ...

apt update
apt install curl -y

for OSX

if you see the following, it means you have an outdated brew on your laptop

## stderr:
Error: Cannot install under Rosetta 2 in ARM default prefix (/opt/homebrew)!

to fix:

#uninstall
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
rm -rf /opt/homebrew
#re-install homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"