This commit is contained in:
despiegk 2025-06-16 10:27:14 +02:00
parent 52db50342a
commit ccd01c291d
61 changed files with 127 additions and 127 deletions

View File

@ -17,7 +17,7 @@
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).
To see the whole list of books, check the [heroscript directory](https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript).
## Basic Hero mdBook Commands
@ -25,19 +25,19 @@ Once Hero is set on your machine, you can run the following commands to preview
- Pull new changes
```
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/nameofyourbook -gp
hero mdbook -u https://git.threefold.info/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
hero mdbook -u https://git.threefold.info/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
hero mdbook -u https://git.threefold.info/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).
> Note: You can use -p instead of -u and set a path to your heroscript directory, as explained in the [docs](https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/docs).
## Install and Use Hero

View File

@ -1,5 +1,5 @@
#!/bin/bash
set -ex
export NAME=devs
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/manual/heroscript/$NAME
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/manual/heroscript/$NAME
rsync -rv ~/hero/www/info/$NAME/ root@info.ourworld.tf:/root/hero/www/info/$NAME/

View File

@ -1,6 +1,6 @@
#!/bin/bash
set -ex
export NAME=duniayetu_dar
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/$NAME
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript/$NAME
rsync -rv ~/hero/www/info/$NAME/ root@info.ourworld.tf:/root/hero/www/info/$NAME/
åç

View File

@ -1,5 +1,5 @@
#!/bin/bash
set -ex
export NAME=farmers
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/manual/heroscript/$NAME
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/manual/heroscript/$NAME
rsync -rv ~/hero/www/info/$NAME/ root@info.ourworld.tf:/root/hero/www/info/$NAME/

View File

@ -1,5 +1,5 @@
#!/bin/bash
set -ex
export NAME=knowledge_base
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/manual/heroscript/$NAME
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/manual/heroscript/$NAME
rsync -rv ~/hero/www/info/$NAME/ root@info.ourworld.tf:/root/hero/www/info/$NAME/

View File

@ -1,5 +1,5 @@
#!/bin/bash
set -ex
export NAME=legal
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/$NAME
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript/$NAME
rsync -rv ~/hero/www/info/$NAME/ root@info.ourworld.tf:/root/hero/www/info/$NAME/

View File

@ -1,5 +1,5 @@
#!/bin/bash
set -ex
export NAME=library
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/manual/heroscript/$NAME
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/manual/heroscript/$NAME
rsync -rv ~/hero/www/info/$NAME/ root@info.ourworld.tf:/root/hero/www/info/$NAME/

View File

@ -1,5 +1,5 @@
#!/bin/bash
set -ex
export NAME=manual
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/manual/heroscript/$NAME
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/manual/heroscript/$NAME
rsync -rv ~/hero/www/info/$NAME/ root@info.ourworld.tf:/root/hero/www/info/$NAME/

View File

@ -1,5 +1,5 @@
#!/bin/bash
set -ex
export NAME=mbweni
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/$NAME
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript/$NAME
rsync -rv ~/hero/www/info/$NAME/ root@info.ourworld.tf:/root/hero/www/info/$NAME/

View File

@ -1,8 +1,8 @@
set -ex
#~/code/git.ourworld.tf/tfgrid/info_tfgrid/books/manual/sync_production.sh
~/code/git.ourworld.tf/tfgrid/info_tfgrid/books/kristof/sync_production.sh
~/code/git.ourworld.tf/tfgrid/info_tfgrid/books/legal/sync_production.sh
~/code/git.ourworld.tf/tfgrid/info_tfgrid/books/tech/sync_production.sh
~/code/git.ourworld.tf/tfgrid/info_tfgrid/books/tfgrid3/sync_production.sh
#~/code/git.ourworld.tf/tfgrid/info_tfgrid/books/mbweni/sync_production.sh
#~/code/git.ourworld.tf/tfgrid/info_tfgrid/books/duniayetu_dar/sync_production.sh
#~/code/git.threefold.info/tfgrid/info_tfgrid/books/manual/sync_production.sh
~/code/git.threefold.info/tfgrid/info_tfgrid/books/kristof/sync_production.sh
~/code/git.threefold.info/tfgrid/info_tfgrid/books/legal/sync_production.sh
~/code/git.threefold.info/tfgrid/info_tfgrid/books/tech/sync_production.sh
~/code/git.threefold.info/tfgrid/info_tfgrid/books/tfgrid3/sync_production.sh
#~/code/git.threefold.info/tfgrid/info_tfgrid/books/mbweni/sync_production.sh
#~/code/git.threefold.info/tfgrid/info_tfgrid/books/duniayetu_dar/sync_production.sh

View File

@ -1,5 +1,5 @@
#!/bin/bash
set -ex
export NAME=sysadmins
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/manual/heroscript/$NAME
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/manual/heroscript/$NAME
rsync -rv ~/hero/www/info/$NAME/ root@info.ourworld.tf:/root/hero/www/info/$NAME/

View File

@ -1,3 +1,3 @@
#!/bin/bash
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/tfgrid3
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript/tfgrid3
rsync -rv ~/hero/www/info/tfgrid3/ root@info.ourworld.tf:/root/hero/www/info/tfgrid3/

View File

@ -1,2 +1,2 @@
https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/development/heroscript/projectinca
https://git.threefold.info/tfgrid/info_tfgrid/src/branch/development/heroscript/projectinca

View File

@ -10,5 +10,5 @@ Its important that every contributor to this project has gone over next checklis
Some practical items:
- [ ] [I have an account on gitea](https://git.ourworld.tf)
- [ ] [I am committed to work with our Kanban on Gitea](https://git.ourworld.tf/tfgrid/circle_go2market/projects/80)
- [ ] [I have an account on gitea](https://git.threefold.info)
- [ ] [I am committed to work with our Kanban on Gitea](https://git.threefold.info/tfgrid/circle_go2market/projects/80)

View File

@ -4,5 +4,5 @@
Let's all together work together on this document as well as on the stories which make up our planning.
- [Git repo for this manual](https://git.ourworld.tf/tfgrid/info_tfgrid)
- [Stories for contributors only (Ask access)](https://git.ourworld.tf/tfgrid/depin_circle/issues)
- [Git repo for this manual](https://git.threefold.info/tfgrid/info_tfgrid)
- [Stories for contributors only (Ask access)](https://git.threefold.info/tfgrid/depin_circle/issues)

View File

@ -6,7 +6,7 @@ There is a grant of 5m TFT foreseen for the work as will be done by the codescal
## Requirements
- The work as defined on [project management tool](https://git.ourworld.tf/tfgrid/-/projects/46) is executed and delivered
- The work as defined on [project management tool](https://git.threefold.info/tfgrid/-/projects/46) is executed and delivered
- Project is delivered
- opensource
- customers operational

View File

@ -6,7 +6,7 @@ There is a grant of 2m TFT foreseen for the work as will be done by the codescal
## Requirements
- The work as defined on [project management tool](https://git.ourworld.tf/tfgrid/-/projects/99) is executed and delivered
- The work as defined on [project management tool](https://git.threefold.info/tfgrid/-/projects/99) is executed and delivered
- Project is delivered
- opensource
- customers operational

View File

@ -1,7 +1,7 @@
# Stories
- [circle issues](https://git.ourworld.tf/tfgrid/circle_projectinca/issues)
- [kanban view](https://git.ourworld.tf/tfgrid/-/projects/68)
- [circle issues](https://git.threefold.info/tfgrid/circle_projectinca/issues)
- [kanban view](https://git.threefold.info/tfgrid/-/projects/68)
> TODO: we need to udpate our issues and track our work

View File

@ -6,7 +6,7 @@
title: 'ThreeFold: Reinventing the Internet'
!!slides.add_collection
url: 'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/development/collections/slides_threefold_depin'
url: 'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/development/collections/slides_threefold_depin'
!!slides.add_slide
name: 'threefold_intro_depin.png'

View File

@ -21,7 +21,7 @@ The Gitea API is available with the slugs `/api/swagger#` after your Gitea domai
- For ThreeFold, we use the following Gitea API:
```
https://git.ourworld.tf/api/swagger#/
https://git.threefold.info/api/swagger#/
```
You can access different levels of the Gitea instance:
@ -48,7 +48,7 @@ For example, we take the raw content of a file:
```
curl -X 'GET' \
'https://git.ourworld.tf/api/v1/repos/tfgrid/info_tfgrid/raw/heroscript%2Fduniayetu%2Fbook_collections.md?ref=main' \
'https://git.threefold.info/api/v1/repos/tfgrid/info_tfgrid/raw/heroscript%2Fduniayetu%2Fbook_collections.md?ref=main' \
-H 'accept: application/json'
```
@ -56,7 +56,7 @@ We can save this in a file by adding `> filename.txt` after the line above:
```
curl -X 'GET' \
'https://git.ourworld.tf/api/v1/repos/tfgrid/info_tfgrid/raw/heroscript%2Fduniayetu%2Fbook_collections.md?ref=main' \
'https://git.threefold.info/api/v1/repos/tfgrid/info_tfgrid/raw/heroscript%2Fduniayetu%2Fbook_collections.md?ref=main' \
-H 'accept: application/json' > filename.txt
```
@ -73,7 +73,7 @@ If you want to query information that is access-protected, such as a private rep
Once this is done, every Swagger request you ask will be accompanied with the access token.
- Create an access token directly on Gitea
- Go to the `Applications` section of the `User Settings` [on Gitea](https://git.ourworld.tf/user/settings/applications)
- Go to the `Applications` section of the `User Settings` [on Gitea](https://git.threefold.info/user/settings/applications)
- Under `Manage Access Tokens`, choose a `Token Name`
- Select either ̀`Public only` or `All (public, private and limited)`. For private access, choose the latter
- You must select at least one permission to create a token. Click on `Select permissions` and choose the permissions for your token

View File

@ -23,7 +23,7 @@
We present a basic guide for Gitea, a forge software package for hosting software development version control using Git as well as other collaborative features like bug tracking, code review, continuous integration, kanban boards, tickets, and wikis.
ThreeFold hosts its own git server on [Gitea OurWorld](https://git.ourworld.tf). We will be using OurWorld's Gitea instance for this guide.
ThreeFold hosts its own git server on [Gitea OurWorld](https://git.threefold.info). We will be using OurWorld's Gitea instance for this guide.
## Prerequisites
@ -38,7 +38,7 @@ You should have git installed on your computer to work easily with Gitea. It is
## Register
- Go to the main gitea URL, e.g. [https://git.ourworld.tf](https://git.ourworld.tf)
- Go to the main gitea URL, e.g. [https://git.threefold.info](https://git.threefold.info)
- On the top right click on `Register`
- Set your credentials
- Enter a `Username`
@ -50,7 +50,7 @@ You should have git installed on your computer to work easily with Gitea. It is
## Sign In
- Go to the main Gitea URL, e.g. [https://git.ourworld.tf](https://git.ourworld.tf)
- Go to the main Gitea URL, e.g. [https://git.threefold.info](https://git.threefold.info)
- On the top right click on `Sign In`
- Set your credentials
- Enter your `Username` or your `Email Address`
@ -69,7 +69,7 @@ ssh-keygen
```
cat ~/.ssh/id_rsa.pub
```
- [Add the SSH public key on git.ourworld.tf](https://git.ourworld.tf/user/settings/keys)
- [Add the SSH public key on git.threefold.info](https://git.threefold.info/user/settings/keys)
- Click on `Add Key` on the top right
- Paste the public key in `Content`
- The `Key Name` will be added automatically
@ -77,7 +77,7 @@ cat ~/.ssh/id_rsa.pub
![](./img/gitea_ssh_key.png)
- Optional: on git.ourworld.tf, verify the key. Make sure to put the proper token.
- Optional: on git.threefold.info, verify the key. Make sure to put the proper token.
```
echo -n 'token' | ssh-keygen -Y sign -n gitea -f ~/.ssh/id_rsa
```

View File

@ -10,4 +10,4 @@ We highly encourage feedback and discussions around the next grid release.
<h2>Contribute</h2>
Use the [ThreeFold forum](https://forum.threefold.io/c/dao/rfc/81) to discuss the content or edit directly in [our Git system](https://git.ourworld.tf/tfgrid/info_tfgrid).
Use the [ThreeFold forum](https://forum.threefold.io/c/dao/rfc/81) to discuss the content or edit directly in [our Git system](https://git.threefold.info/tfgrid/info_tfgrid).

View File

@ -18,7 +18,7 @@
We show how to build an mdbook using the [Hero tool](https://github.com/freeflowuniverse/crystallib/tree/development/cli/hero).
For this guide, we will show how to add an mdbook to the TFGrid repository `info_tfgrid` on `git.ourworld.tf`.
For this guide, we will show how to add an mdbook to the TFGrid repository `info_tfgrid` on `git.threefold.info`.
## Prerequisites
@ -33,13 +33,13 @@ Let's go through all the steps to create a new mdbook. We will call our book `ne
For this guide, we will add a book to `info_tfgrid`. For this reason, we first start to clone the repository. Note that this step can be done automatically by Hero, but it might be easier to do it manually for later steps, such as pushing changes with git.
```
mkdir -p /root/code/git.ourworld.tf/tfgrid
cd /root/code/git.ourworld.tf/tfgrid
git clone https://git.ourworld.tf/tfgrid/info_tfgrid
mkdir -p /root/code/git.threefold.info/tfgrid
cd /root/code/git.threefold.info/tfgrid
git clone https://git.threefold.info/tfgrid/info_tfgrid
cd info_tfgrid
```
Once we've cloned the repository, we can make changes to the repository and then push it to `git.ourworld.tf` when we're ready.
Once we've cloned the repository, we can make changes to the repository and then push it to `git.threefold.info` when we're ready.
Before creating the new mdbook, let's have a look at how the overall directory tree will look like.
@ -108,11 +108,11 @@ Hero uses three main directories to build an mdbook `books`, `collections` and `
- In the directory `collections` as we've seen above
```
\!!book.generate name:'new_mdbook' title:'New mdbook'
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/new_mdbook'
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript/new_mdbook'
\!!doctree.add
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/collections/new_mdbook'
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/collections/new_mdbook'
```
@ -138,7 +138,7 @@ pushd /root/hero/www/info/new_mdbook/; python3 -m http.server 5173; popd;
## Pushing the Changes
Once you've set the files and directories for your new mdbook and that you are satisfied with the result, you can push the changes to `git.ourworld.tf`.
Once you've set the files and directories for your new mdbook and that you are satisfied with the result, you can push the changes to `git.threefold.info`.
```
git add .
@ -152,9 +152,9 @@ Once the changes are uploaded to the remote repository, you will be able to upda
- Update the repository
```
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/new_mdbook -gr
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript/new_mdbook -gr
```
- Build the book
```
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/new_mdbook -o
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript/new_mdbook -o
```

View File

@ -34,9 +34,9 @@ Note that you will need to adjust the local path of the git repo and the docker
- On a terminal window, create the code repository on the local machine
```
mkdir -p ~/code/git.ourworld.tf/tfgrid
cd ~/code/git.ourworld.tf/tfgrid
git clone https://git.ourworld.tf/tfgrid/info_tfgrid
mkdir -p ~/code/git.threefold.info/tfgrid
cd ~/code/git.threefold.info/tfgrid
git clone https://git.threefold.info/tfgrid/info_tfgrid
```
- Start Hero docker
```
@ -48,21 +48,21 @@ Note that you will need to adjust the local path of the git repo and the docker
```
- Change directory
```
cd ~/code/git.ourworld.tf/tfgrid/info_tfgrid
cd ~/code/git.threefold.info/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
git config --global --add safe.directory /root/code/git.threefold.info/tfgrid/info_tfgrid
```
- 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/tech
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript/tech
```
- With a path:
```
hero mdbook -p /root/code/git.ourworld.tf/tfgrid/info_tfgrid/heroscript/tech
hero mdbook -p /root/code/git.threefold.info/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:
@ -99,15 +99,15 @@ You can use [VSCodium](https://manual.grid.tf/documentation/system_administrator
- Open VSCodium
- Open the directory where the repo is located, e.g.
```
cd ~/code/git.ourworld.tf/tfgrid/info_tfgrid
cd ~/code/git.threefold.info/tfgrid/info_tfgrid
```
- Make changes and save the files
- Redeploy Hero Mdbook
- With a path:
```
hero mdbook -p /root/code/git.ourworld.tf/tfgrid/info_tfgrid/heroscript/tech
hero mdbook -p /root/code/git.threefold.info/tfgrid/info_tfgrid/heroscript/tech
```
- With a URL (make sure to pull the changes with `git pull`):
```
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/tech
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript/tech
```

View File

@ -19,7 +19,7 @@
In this tutorial, we show all the steps to deploy an mdbook with the [Hero](https://github.com/freeflowuniverse/crystallib/tree/development/cli/hero) tool.
For this guide, we show an example using the mdbook from the repository [info_tfgrid](https://git.ourworld.tf/tfgrid/info_tfgrid). This setup can be done locally or on a VM. Note that it should be run as root.
For this guide, we show an example using the mdbook from the repository [info_tfgrid](https://git.threefold.info/tfgrid/info_tfgrid). This setup can be done locally or on a VM. Note that it should be run as root.
We show the steps for a full VM deployed on the TFGrid with WireGuard. We use `10.20.4.2` as a WireGuard IP address. Adjust according to your own setup.
@ -70,8 +70,8 @@ ssh-keygen
```
cat /root/.ssh/books.pub
```
- Add the SSH public key on [git.ourworld.tf](https://git.ourworld.tf/user/settings/keys) and [github](https://github.com/settings/keys)
- Optional: on git.ourworld.tf, verify the key. Make sure to put the proper token.
- Add the SSH public key on [git.threefold.info](https://git.threefold.info/user/settings/keys) and [github](https://github.com/settings/keys)
- Optional: on git.threefold.info, verify the key. Make sure to put the proper token.
```
echo -n 'token' | ssh-keygen -Y sign -n gitea -f /root/.ssh/books
```
@ -101,13 +101,13 @@ Download the git repository from a URL:
- Download the repository
```
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/bookname -gp
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript/bookname -gp
```
- The line above will clone the repository `info_tfgrid` at the path `/root/code/git.ourworld.tf/tfgrid`. The same result can be obtained by running the following lines:
- The line above will clone the repository `info_tfgrid` at the path `/root/code/git.threefold.info/tfgrid`. The same result can be obtained by running the following lines:
```
mkdir -p /root/code/git.ourworld.tf/tfgrid
cd /root/code/git.ourworld.tf/tfgrid
git clone https://git.ourworld.tf/tfgrid/info_tfgrid
mkdir -p /root/code/git.threefold.info/tfgrid
cd /root/code/git.threefold.info/tfgrid
git clone https://git.threefold.info/tfgrid/info_tfgrid
```
For the next steps, you can either run the commands locally (with -p and the proper path) or remotely (with -u and the proper URL). Running the command locally is useful when you are doing changes to the mdbook and you want to test them before pushing the new files to the remote repository.
@ -116,7 +116,7 @@ For the next steps, you can either run the commands locally (with -p and the pro
- Note: add the parameter `-o` at the end of the line to open the book with your local browser
- Option 1: Build the book with a URL
```
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/bookname
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript/bookname
```
- Option 2: Build the book with a local path
@ -135,10 +135,10 @@ pushd /root/hero/www/info/<book_name>/; python3 -m http.server 5173; popd;
### Fix the error: "cli execution error: Cannot pull repo..."
If you get the following error: "cli execution error: Cannot pull repo: /root/code/git.ourworld.tf/tfgrid/info_tfgrid because there are changes in the dir.", you can try the following as a fix:
If you get the following error: "cli execution error: Cannot pull repo: /root/code/git.threefold.info/tfgrid/info_tfgrid because there are changes in the dir.", you can try the following as a fix:
```
rm -r /root/code/git.ourworld.tf/tfgrid/info_tfgrid
rm -r /root/code/git.threefold.info/tfgrid/info_tfgrid
```
### Fix: Git hangs at "Cloning into..."
@ -152,8 +152,8 @@ git config --global credential.provider generic
If it happens another time, you can try to download it manually:
```
mkdir -p /root/code/git.ourworld.tf/tfgrid && cd $_
git clone https://git.ourworld.tf/tfgrid/info_tfgrid
mkdir -p /root/code/git.threefold.info/tfgrid && cd $_
git clone https://git.threefold.info/tfgrid/info_tfgrid
```
## Distinctions between mdbook and hero mdbook

View File

@ -38,7 +38,7 @@ bash /tmp/hero_install.sh
# Start the SSH agent, run hero mdbook and build the mdbook
eval $(ssh-agent)
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript
cd /root/hero/var/mdbuild/duniayetu
mdbook build

View File

@ -1,3 +1,3 @@
#!/bin/bash
export NAME="datacenter"
hero mdbook -u https://git.ourworld.tf/ourworld_holding/info_ourworld/src/branch/development/heroscript/$NAME -o
hero mdbook -u https://git.threefold.info/ourworld_holding/info_ourworld/src/branch/development/heroscript/$NAME -o

View File

@ -3,7 +3,7 @@
title:'Threefold Developers Manual'
description: 'ThreeFold Manual for Developers'
name:'devs'
summary_url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/books/devs'
summary_url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/books/devs'
collections:'manual, dashboard, tfconnect, developers, farmers, system_administrators, threefold_token, faq, about, tech, legal, farming, cloud, collaboration, partners_utilization, vindo, mkondo'
production:0 //means we put it in summary
```

View File

@ -3,4 +3,4 @@
fail_on_error: false
!!doctree.add
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/development/collections'
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/development/collections'

View File

@ -4,7 +4,7 @@
title:'Dunia Yetu'
description: 'mdbook about Dunia Yetu'
name:'duniayetu'
summary_url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/books/duniayetu'
summary_url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/books/duniayetu'
collections:'collections'
production:0 //means we put it in summary
```

View File

@ -4,7 +4,7 @@
title:'EarthHub'
description:'EarthHub mdbook"
name:'earthhub'
summary_url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/books/earthhub'
summary_url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/books/earthhub'
collections:'earthhub, social_media_protocols, tech, p2p, def'
production:0 //means we put it in summary
```

View File

@ -1,12 +1,12 @@
!!gittools.pull coderoot:'~/hero/var/code' readonly:true url:'https://git.ourworld.tf/tfgrid/info_tfgrid' branch:'main'
!!gittools.pull coderoot:'~/hero/var/code' readonly:true url:'https://git.threefold.info/tfgrid/info_tfgrid' branch:'main'
!!doctree.add
name:'info_tfgrid'
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/collections
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/collections
!!doctree.export
@ -17,7 +17,7 @@
!!mdbook.export
title:'ThreeFold Technology'
name:'tech'
summary:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/development/books/tech/SUMMARY.md'
summary:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/development/books/tech/SUMMARY.md'
collections:'
~/hero/var/collections/info_tfgrid
~/hero/var/collections/info_tfgrid

View File

@ -4,7 +4,7 @@ set -ex
#~/code/github/freeflowuniverse/crystallib/cli/hero/compile_debug.sh
#~/code/github/freeflowuniverse/crystallib/cli/hero/compile.sh
hero run -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/development/heroscript/exporter
hero run -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/development/heroscript/exporter
#result will be in /root/hero/var/mdbuild/tfgrid4simulator

View File

@ -3,7 +3,7 @@
title:'Threefold Grid Farmers'
description:'ThreeFold Manual for Farmers'
name:'farmers'
summary_url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/books/farmers'
summary_url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/books/farmers'
collections:'manual, dashboard, tfconnect, developers, farmers, system_administrators, threefold_token, faq, about, tech, legal, farming, cloud, collaboration, partners_utilization, vindo, mkondo'
production:0 //means we put it in summary
```

View File

@ -3,7 +3,7 @@
title:'ThreeFold Knowledge Base'
description:'Knowledge Base of ThreeFold'
name:'knowledge_base'
summary_url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/books/knowledge_base'
summary_url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/books/knowledge_base'
collections:'manual, dashboard, tfconnect, developers, farmers, system_administrators, threefold_token, faq, about, tech, legal, farming, cloud, collaboration, partners_utilization, vindo, mkondo'
production:0 //means we put it in summary
```

View File

@ -4,7 +4,7 @@
title:'Legal'
description:'Legal book of ThreeFold'
name:'legal'
summary_url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/books/legal'
summary_url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/books/legal'
collections:'legal, companies, tfgrid3'
production:0 //means we put it in summary
```

View File

@ -3,7 +3,7 @@
title:'Library'
description:'ThreeFold Library'
name:'library'
summary_url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/books/library'
summary_url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/books/library'
collections:'library'
production:0 //means we put it in summary
```

View File

@ -3,7 +3,7 @@
title:'Threefold Manual'
description:'ThreeFold Manual'
name:'manual'
summary_url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/books/manual'
summary_url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/books/manual'
collections:'manual, dashboard, tfconnect, developers, farmers, system_administrators, threefold_token, faq, about, tech, legal, farming, cloud, collaboration, partners_utilization, vindo, mkondo'
production:0 //means we put it in summary
```

View File

@ -4,7 +4,7 @@
title:'Mbweni Ruins and Gardens'
description:'Mbweni Ruins and Gardens book'
name:'mbweni'
summary_url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/books/mbweni'
summary_url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/books/mbweni'
collections:'mbweni, freeflow'
production:0 //means we put it in summary
```

View File

@ -3,7 +3,7 @@ set -ex
#~/code/github/freeflowuniverse/crystallib/cli/hero/compile_debug.sh
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/development/heroscript/projectinca -o
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/development/heroscript/projectinca -o
#result will be in /root/hero/var/mdbuild/tfgrid4simulator

View File

@ -1,44 +1,44 @@
!!book.generate name:'projectinca' title:'Project INCA Launch'
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/projectinca'
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript/projectinca'
!!doctree.add
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/collections/def'
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/collections/def'
!!doctree.add
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/collections/tech'
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/collections/tech'
!!doctree.add
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/collections/projectinca'
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/collections/projectinca'
!!doctree.add
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/collections/projectmycelium'
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/collections/projectmycelium'
!!doctree.add
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/collections/partners_utilization'
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/collections/partners_utilization'
!!doctree.add
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/collections/why'
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/collections/why'
!!doctree.add
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/collections/vindo'
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/collections/vindo'
!!doctree.add
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/collections/mkondo'
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/collections/mkondo'
!!doctree.add
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/collections/values'
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/collections/values'
!!doctree.add
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/collections/tfgrid4'
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/collections/tfgrid4'
!!doctree.add
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/collections/tfgrid3'
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/collections/tfgrid3'
!!doctree.add
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/collections/p2p'
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/collections/p2p'

View File

@ -1,3 +1,3 @@
#!/bin/bash
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/projectinca
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript/projectinca
rsync -rv ~/hero/www/info/projectinca/ root@info.ourworld.tf:/root/hero/www/info/projectinca/

View File

@ -1,4 +1,4 @@
#!/bin/bash
export NAME="datacenter"
hero mdbook -u https://git.ourworld.tf/ourworld_holding/info_ourworld/src/branch/development/heroscript/$NAME
hero mdbook -u https://git.threefold.info/ourworld_holding/info_ourworld/src/branch/development/heroscript/$NAME
rsync -rv ~/hero/www/info/${NAME}/ root@info.ourworld.tf:/root/hero/www/info/${NAME}/

View File

@ -3,7 +3,7 @@
title:'ThreeFold System Administrators Manual'
description:'ThreeFold System Administrators Manual'
name:'sysadmins'
summary_url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/books/sysadmins'
summary_url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/books/sysadmins'
collections:'manual, dashboard, tfconnect, developers, farmers, system_administrators, threefold_token, faq, about, tech, legal, farming, cloud, collaboration, partners_utilization, vindo, mkondo'
production:0 //means we put it in summary
```

View File

@ -4,7 +4,7 @@
title:'Threefold Technology'
description:'ThreeFold Technology book'
name:'tech'
summary_url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/books/tech'
summary_url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/books/tech'
collections:'tech, p2p, def, partners_utilization, vindo, mkondo'
production:0 //means we put it in summary
```

View File

@ -1,3 +1,3 @@
#!/bin/bash
export NAME=tech
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/${NAME} -o
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript/${NAME} -o

View File

@ -1,4 +1,4 @@
#!/bin/bash
export NAME=tech
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/${NAME} -o
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript/${NAME} -o
rsync -rv ~/hero/www/info/${NAME}/ root@info.ourworld.tf:/root/hero/www/info/${NAME}/

View File

@ -4,7 +4,7 @@
title:'Mdbook Test'
description:'Mdbook Test'
name:'test'
summary_url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/books/test'
summary_url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/books/test'
collections:'test'
production:0 //means we put it in summary
```

View File

@ -4,7 +4,7 @@
title:'ThreeFold Grid 3.14'
descritpion:'ThreeFold Grid 3.14 book'
name:'tfgrid3'
summary_url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/books/tfgrid3'
summary_url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/books/tfgrid3'
collections:'tfgrid3, def, tech, values, partners_utilization'
production:0 //means we put it in summary
```

View File

@ -4,7 +4,7 @@
title:'TFGrid Internet 4.0'
description:'TFGrid V4 mdbook'
name:'tfgrid4'
summary_url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/books/tfgrid4'
summary_url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/books/tfgrid4'
collections:'bestkeptsecret, why, farming_v4, economy, p2p, partners_utilization, solutions, web4, tech, values, problems, dy_intro'
production:0 //means we put it in summary
```

View File

@ -5,7 +5,7 @@ export NAME="tfgrid4simulation"
~/code/github/freeflowuniverse/crystallib/cli/hero/compile_debug.sh
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/development/heroscript/${NAME} -o
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/development/heroscript/${NAME} -o
#result will be in /root/hero/var/mdbuild/tfgrid4simulation

View File

@ -3,11 +3,11 @@
```js
!!book.generate name:'tfgrid4simulator' title:'TFGrid Simulator 4.0'
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/development/heroscript/tfgrid4simulation'
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/development/heroscript/tfgrid4simulation'
!!doctree.add
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/development/collections/tfgridsimulation'
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/development/collections/tfgridsimulation'
```

View File

@ -2,5 +2,5 @@
export NAME="tfgrid4simulation"
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/${NAME}
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript/${NAME}
rsync -rv ~/hero/www/info/${NAME}/ root@info.ourworld.tf:/root/hero/www/info/${NAME}/

View File

@ -5,7 +5,7 @@ export NAME="tfgrid4simulation_farming"
#~/code/github/freeflowuniverse/crystallib/cli/hero/compile_debug.sh
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/development/heroscript/${NAME} -o
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/development/heroscript/${NAME} -o
#result will be in /root/hero/var/mdbuild/tfgrid4simulation

View File

@ -3,11 +3,11 @@
```js
!!book.generate name:'tfgridsimulation_farming' title:'TFGrid Simulator 4.0 - Farming'
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/development/heroscript/tfgrid4simulation_farming'
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/development/heroscript/tfgrid4simulation_farming'
!!doctree.add
url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/development/collections/tfgridsimulation_farming'
url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/development/collections/tfgridsimulation_farming'
```

View File

@ -2,5 +2,5 @@
export NAME="tfgrid4simulation_farming"
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/${NAME}
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript/${NAME}
rsync -rv ~/hero/www/info/${NAME}/ root@info.ourworld.tf:/root/hero/www/info/${NAME}/

View File

@ -4,7 +4,7 @@
title:'TFGrid Specs 4.0'
description:'TFGrid Specs 4.0 book'
name:'tfgrid4specs'
summary_url:'https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/books/tfgrid4specs'
summary_url:'https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/books/tfgrid4specs'
collections:'tfgrid4specs, tech, tfgrid4'
production:0 //means we put it in summary
```

View File

@ -3,6 +3,6 @@ set -ex
#~/code/github/freeflowuniverse/crystallib/cli/hero/compile_debug.sh
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/development/heroscript/tfgrid4specs -o
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/development/heroscript/tfgrid4specs -o

View File

@ -1,3 +1,3 @@
#!/bin/bash
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript/tfgrid4specs
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript/tfgrid4specs
rsync -rv --delete ~/hero/www/info/tfgrid4specs/ root@info.ourworld.tf:/root/hero/www/info/tfgrid4specs/

View File

@ -38,7 +38,7 @@ bash /tmp/hero_install.sh
# Start the SSH agent, run hero mdbook and build the mdbook
eval $(ssh-agent)
hero mdbook -u https://git.ourworld.tf/tfgrid/info_tfgrid/src/branch/main/heroscript
hero mdbook -u https://git.threefold.info/tfgrid/info_tfgrid/src/branch/main/heroscript
cd /root/hero/var/mdbuild/duniayetu
mdbook build

View File

@ -17,7 +17,7 @@ ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC/9RNGKRjHvViunSOXhBF7EumrWvmqAAVJSrfGdLaV
```
- go to [https://git.ourworld.tf/user/settings/keys](https://git.ourworld.tf/user/settings/keys)
- go to [https://git.threefold.info/user/settings/keys](https://git.threefold.info/user/settings/keys)
add the key you found from kds.pub, copy all from ssh-... with email addr. underneith ssh