add documentation for Catmandu::Fix::Bind::each

[jorol]

I've got feedback from Catmandu users, who are missing the fix "Catmandu::Fix::Bind::each" in our documentation and cheat sheet. I know both documentations are not complete, but this fix is in Catmandu core and quite handy...

[phochste]

Fixed the cheat sheet to version 2021-11

[phochste]

Fixed the documentation in the Wiki also, trying to rebuild the librecat.org webpage but I don't see the changes yet appear there.

There a pandoc command in the procedure to produce a Wiki book from our Wikipages that is deprecated. Alas I am not a pandoc expert (and didn't created this routine) described in : https://github.com/LibreCat/librecat.github.io. Maybe @nichtich can help ? I think he created the pandoc version of the Wiki as one book?

[jorol]

@phochste Thanks!

[nichtich]

@phochste can you point me to the build script, log file etc. that involves pandoc?

[phochste]

It is part of the git@github.com:LibreCat/Catmandu.wiki.git repository in the book/ directory. To bad I can't point at it via the web.

Makefile says:

.SUFFIXES: .md .html .pdf
.PHONY: git-clean files push

NAME=index

default: $(NAME).html

$(NAME).md: files ../*.md metadata.yml
    cat metadata.yml > $@
    perl combine-handbook.pl < ../Home.md >> $@

files:
    rsync -r --include="*.jpg" --include="*.png" --exclude="*" ../files/ files/

PANDOC_OPTIONS=--toc -N -s -S --section-divs --template template.html
PANDOC_OPTIONS+=--css https://maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css
PANDOC_OPTIONS+=--css layout.css

.md.html:
    pandoc $(PANDOC_OPTIONS) -t html5 -o $@ $<

# requires LaTeX
.md.pdf:
    pandoc $(PANDOC_OPTIONS) -o $@ $<

git-clean:
    #@if git status --porcelain 2>/dev/null | grep -q .; then echo "Nothing changed"; exit 1; fi
    date

gh-pages: git-clean $(NAME).html
    cp layout.css files
    git checkout gh-pages
    git pull homepage gh-pages
    rsync -r files/ ../files/
    cp $(NAME).html ../index.html
    mv files/layout.css ..

With my pandoc pandoc 2.16.1 I get

rsync -r --include="*.jpg" --include="*.png" --exclude="*" ../files/ files/
cat metadata.yml > index.md
perl combine-handbook.pl < ../Home.md >> index.md
pandoc --toc -N -s -S --section-divs --template template.html --css https://maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css --css layout.css -t html5 -o index.html index.md
--smart/-S has been removed.  Use +smart or -smart extension instead.
For example: pandoc -f markdown+smart -t markdown-smart.
Try pandoc --help for more information.
make: *** [index.html] Error 6

[phochste]

I got the homepage generation page scripts too work..but I still don't understand completely how it works.