shlomifish.org INSTALL [by Shlomi Fish]2022-10-27ShlomiFishshlomif@shlomifish.orgShlomi Fish’s Homepage2022Shlomi FishCC-by dedication
This work is licensed under the Creative Commons Attribution 4.0 License (CC-by) (or at your option a greater version of it).
Docker script
perl bin/docker-ci-run.pl --cleanrun 2>&1 | tee "${HOME}/shlomif-homepage.build.out.txt"
Main
Follow the following steps to build the homesite:
Install git - http://git-scm.com/ .
Install perl 5.16.x (or later) in case it’s not already installed.
You should have a package for it for your system.
Install Website Meta Language (version 2.28.0 or later):
https://github.com/thewml/website-meta-language/releases
Run and configure CPAN (see - https://perl-begin.org/topics/cpan/
) and type:
export PERL_MM_USE_DEFAULT=1
perl -MCPAN -e 'install App::Deps::Verify Task::Sites::ShlomiFish'
or:
export PERL_MM_USE_DEFAULT=1
perl -MCPANPLUS -e 'install App::Deps::Verify Task::Sites::ShlomiFish'
or:
export PERL_MM_USE_DEFAULT=1
cpanm App::Deps::Verify Task::Sites::ShlomiFish
Install Latemp:
See https://web-cpan.shlomifish.org/latemp/ and
https://github.com/thewml/latemp .
Add Latemp to the beginning of your path:
PATH="$HOME/apps/latemp/bin:$PATH"
Install the latest version of Quad-Pres from:
See https://www.shlomifish.org/quad-pres/ and
https://github.com/shlomif/quad-pres :
git clone https://github.com/shlomif/quad-pres
cd quad-pres/installer
See its INSTALL file. Put a working quadp
executable in your shell’s PATH.
Install the wml-affiliations.
git clone https://github.com/shlomif/wml-affiliations trunk
cd trunk/wml
bash Install.bash
Install the wml-extended-apis:
git clone https://github.com/thewml/wml-extended-apis trunk
cd trunk/xhtml/1.x/
bash Install.bash
Install inkscape -
version 1.0.x-or-later is recommended, and put its executable in
the path.
Install jing and put it in the path:
http://www.thaiopensource.com/relaxng/jing.html
Install Apache FOP and put it in the path:
http://xmlgraphics.apache.org/fop/
Install
optipng
and put it in the path
Put the XHTML 1.1 DTDs , the XHTML 1.0 DTDs , etc. in your
XML_CATALOG_FILES environment variable.
An easy way to do that is to do:
git clone https://github.com/w3c/markup-validator.git
And set the XML_CATALOG_FILES enviroment variable to
/etc/xml/catalog
$(pwd)/markup-validator/htdocs/sgml-lib/catalog.xml
Do the following to build the site, after all dependencies were
installed:
git clone https://github.com/shlomif/shlomi-fish-homepage.git trunk
cd trunk
if test "${WANT_TO_TEST_SPELLING}" = "1"
then
# May require having Fedora 42 - compatible hunspell wordlists
export SKIP_SPELL_CHECK=",en:lax,"
# export SKIP_SPELL_CHECK=""
else
export SKIP_SPELL_CHECK=",en,"
fi
./gen-helpers
gmake
gmake docbook_extended
gmake test
The site’s pages and data files should be in
dest/post-incs/t2/ .
An optional test is:
bash -x bin/link-checker-for-shlomifish.org.bash