local visualization

.md files are in the content folder, the theme forlder contains the theme.

install Hugo and run it on the current directory.

brew install hugo
hugo serve

The file config.toml contains the global .toml

First generation of publish branch

Some commands that have been used for building:

it clone gh-pages in ./tmp/ and appy all .md files

./reclone.sh

generate toc, title, redirects

python3 migration.py

apply this changes to remove remaining not needed slashes protections

rpl -R ')' ')' * rpl -R '(' '(' *

use carrefully but there should be not .html in content

find "./content/" -name "*.html" -exec rm {} ;

then finally fix link self to images

rpl -R "gitbook/assets/" "gitbook/assets/" * rpl -R "../gitbook/assets" "/gitbook/assets" content rpl -R "..//gitbook/assets" "/gitbook/assets" content rpl -R "’" "'" content rpl -R "✔" "✔" content rpl -R "(../" "(/"

get the images in static

cp tmp/pydocs/gitbook/assets/* static/gitbook/assets/

# detect broken links

wget -o 404.txt -r --spider http://localhost:1313 cat ~/output.txt | grep -B 7 404 | grep "--20"