Re: [Libreboot-dev] Docs: texinfo merging/cleanup

[Leah Rowe]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi Paul,

Just a note, I'm still having issues but I'll study your setup
instructions later so that I can reproduce the same setup as yours.

Op 19/07/16 om 13:47 schreef address@hidden:
> Hi Leah,
> 
> On Tue, Jul 19, 2016 at 12:34:14AM +0100, Leah Rowe wrote:
>> Can you do me a favour. Install lighttpd from scratch on a
>> trisquel server (barebones install from netinstall) and tell me
>> exactly what you had to install as dependency, then in document
>> root create a symlink called "manual" pointing to the manual
>> directory in a libreboot clone directory elsewhere on the system,
>> where you have run the html ./build docs commands with w, and
>> basically document in fine detail everything you're doing, until
>> you get it working.
> 
> The solution I came up with is to create symlinks for both the
> manual and resources directories in the document root. The "w"
> switch is no longer needed.
> 
> Here's the fine detail!
> 
> 
> I installed Trisquel from a netinstall iso like you recommended.
> 
> -------------------
> 
> Building lighttpd:
> 
> # apt-get install git
> 
> $ git clone https://git.lighttpd.net/lighttpd/lighttpd1.4.git
> 
> $ cd lighttpd1.4
> 
> # apt-get install autoconf libtool pkg-config libbz2-dev
> zlib1g-dev ligpcre3-dev
> 
> $ ./autogen.sh
> 
> ### because these two modules are recommended on the lighttpd
> website $ ./configure --with-zlib --with-pcre
> 
> $ make
> 
> # make install
> 
> -------------------
> 
> Building libreboot docs:
> 
> $ cd ~
> 
> $ git clone git://git.savannah.gnu.org/libreboot
> 
> $ cd libreboot
> 
> ### At this point, building the docs fails with "@ref reference to 
> ### nonexistent node" errors. I am attaching a patch that will
> remove ### these errors:
> 
> $ git apply path/to/Update-references-to-SPI-flash-chip-node.patch
> 
> $ ./build docs html
> 
> ### Optional $ ./build docs html-one-page
> 
> ### Optional $ ./build docs html-by-section
> 
> -------------------
> 
> Setting up the server:
> 
> # mkdir -p /var/www/servers/libreboot.org
> 
> $ cd /var/www/servers/libreboot.org
> 
> # ln -s ~/libreboot/docs/manual ./manual # ln -s
> ~/libreboot/docs/resources ./resources
> 
> ### The lighttpd configuration file. Derived from ###
> redmine.lighttpd.net/projects/lighttpd/wiki/TutorialConfiguration $
> echo "server.document-root = \"/var/www/servers/libreboot.org/\"
> 
> server.port = 3000
> 
> server.username = \"www\" server.groupname = \"www\"
> 
> mimetype.assign = ( \".html\" => \"text/html\", \".txt\" =>
> \"text/plain\", \".jpg\" => \"image/jpeg\", \".png\" =>
> \"image/png\" )
> 
> index-file.names = ( \"index.html\" ) " > ~/.lighttpd.conf
> 
> # useradd -r -s /usr/bin/nologin www
> 
> $ lighttpd -t -f ~/.lighttpd.conf
> 
> # lighttpd -D -f ~/.lighttpd.conf
> 
> -------------------
> 
> At this point I was able to visit http://192.168.0.xx:3000/manual 
> (find actual ip with ifconfig or similar) with a different computer
> on the same network and the images showed up.
> 
> I think all the dependencies are pulled in by the commands above,
> but just in case, here is the full list.
> 
> -------------------
> 
> For git: ca-certificates git git-man krb5-locales libasn1-8-heimdal
> libcurl3-gnutls libedit2 liberror-perl libgssapi-krb5-2
> libgssapi3-heimdal libhcrypto4-heimdal libheimbase1-heimdal
> libheimntlm0-heimdal libhx509-5-heimdal libidn11 libk5crypto3
> libkeyutils1 libkrb5-26-heimdal libkrb5-3 libkrb5support0
> libldap-2.4-2 libroken18-heimdal librtmp0 libsasl2-2
> libsasl2-modules libsasl2-modules-db libwind0-heimdal libx11-6 
> libx11-data libxau6 libxcb1 libxdmcp6 libxext6 libxmuu1
> openssh-client openssl patch rsync xauth
> 
> For lighttpd build process: autoconf automake autotools-dev
> libsigsegv2 m4 libltdl-dev libltdl7 libtool pkg-config make
> binutils cpp cpp-4.8 gcc gcc-4.8 libasan0 libatomic1 libc-dev-bin
> libc6-dev libcloog-isl4 libgcc-4.8-dev libgmp10 libgomp1 libisl10
> libitm1 libmpc3 libmpfr4 libpcre3-dev libpcrecpp0 libquadmath0
> libtsan0 linux-libc-dev manpages manpages-dev zlib1g-dev
> libbz2-dev
> 
> Libreboot build docs html: libauthen-sasl-perl
> libencode-locale-perl libfile-listing-perl libfont-afm-perl
> libhtml-form-perl libhtml-format-perl libhtml-parser-perl 
> libhtml-tagset-perl libhtml-tree-perl libhttp-cookies-perl 
> libhttp-daemon-perl libhttp-date-perl libhttp-message-perl 
> libhttp-negotiate-perl libintl-perl libio-html-perl
> libio-socket-inet6-perl libio-socket-ssl-perl
> liblwp-mediatypes-perl liblwp-protocol-https-perl libmailtools-perl
> libnet-http-perl libnet-smtp-ssl-perl libnet-ssleay-perl 
> libsocket6-perl libtext-unidecode-perl libtimedate-perl
> liburi-perl libwww-perl libwww-robotrules-perl libxml-libxml-perl 
> libxml-namespacesupport-perl libxml-parser-perl
> libxml-sax-base-perl libxml-sax-expat-perl libxml-sax-perl texinfo
> 
> -------------------
> 
> More dependencies would be required for building other types of 
> documentation (texlive packages...).
> 
> Let me know if I am on the right track, and if there are any other 
> things that I can try to change before the release. Makeinfo
> provides the option of including a css file -- that would be an
> easy patch. Also, if visting libreboot.org/manual should go
> directly to the index of html-by-node, I could look into that
> (removing the current index and symlinking
> manual/libreboot_by-node/index.html to manual/index.html would
> work, but maybe there's a cleaner way with URL redirection?).
> 
> Thanks again! Paul
> 

- -- 
Leah Rowe

Libreboot developer

Use free software. Free as in freedom.
https://www.gnu.org/philosophy/free-sw.html

Use a free operating system, GNU/Linux.
https://www.gnu.org/

Use a free BIOS.
https://libreboot.org/

Support freedom. Join the Free Software Foundation.
https://fsf.org/

Minifree Ltd, trading as Ministry of Freedom | Registered in England,
No. 9361826 | VAT No. GB202190462
Registered Office: 19 Hilton Road, Canvey Island, Essex SS8 9QA, UK |
Web: http://minifree.org/

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.22 (GNU/Linux)

iQEcBAEBAgAGBQJXtNgrAAoJEP9Ft0z50c+Ux0kIAJTXxS35kuSuQ7/cZiZ0d4il
KMw0z6yR1+Ti9463JF0B2HxkATN6WoDV91gHDUP2bv5UtRRQOebluFvMYMFvgZHP
l2u3DG3pCUcwcKmHzwmH3wHrwFtIAwY6KRyD+cCCX69fczRKfPBpLoCv2Bnywppc
TTk+XiGb4HBUmv2FZahcM/c5VrVOpSUoXef1IPWWrtATVAd7N3MJZZkRkDE70v6i
Fo263+iAZshYraEv9wUwm8JyHYTzxXKtzFp+AmeKHWmAP7nts8K0txKDtrgc6Obl
YNF/UWCoE9mm5ahaWb4NCxxVudB2LAT/xjIDDpGI5yV14KbNB89ovDlabhOPLX0=
=6LXo
-----END PGP SIGNATURE-----