Fork of gnome.org library-web, to generate doc.entrouvert.org
This repository has been archived on 2023-02-21. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Frédéric Péters bfdbf9bac2 add proper abstract for Lasso 2012-04-29 15:12:51 +02:00
data add proper abstract for Lasso 2012-04-29 15:12:51 +02:00
po Updated Galician translations 2012-04-19 18:31:48 +02:00
src arrange things for doc.entrouvert.org 2012-04-29 14:54:53 +02:00
web temporarily disable sqlite connection reuse 2011-04-06 17:31:18 +05:30
.gitignore add .gitignore 2009-05-06 21:27:50 +02:00
AUTHORS merged my code in trunk, tried to do it with history conservation for xslt and 2007-07-31 09:02:39 +00:00
COPYING merged my code in trunk, tried to do it with history conservation for xslt and 2007-07-31 09:02:39 +00:00
ChangeLog.pre-git move obsolete ChangeLog out of the way 2009-04-22 21:42:43 +02:00
INSTALL merged my code in trunk, tried to do it with history conservation for xslt and 2007-07-31 09:02:39 +00:00
MAINTAINERS Add MAINTAINERS file 2007-08-12 00:21:35 +00:00
Makefile.am added necessary autotools stuff for gnome-doc-utils. [lost when migrating 2007-08-08 08:03:32 +00:00
NEWS merged my code in trunk, tried to do it with history conservation for xslt and 2007-07-31 09:02:39 +00:00
README new --rebuild-language option, to force rebuilding of pages in a given 2007-09-10 23:11:22 +00:00
acinclude.m4 add redefinitions of some standard macros to acinclude.m4 2011-04-01 17:17:53 +05:30
autogen.sh touch ChangeLog as required by automake 2009-04-22 22:07:14 +02:00
configure.ac added necessary autotools stuff for gnome-doc-utils. [lost when migrating 2007-08-08 08:03:32 +00:00
library-web.doap doap: add gnome prefix 2009-04-23 23:56:20 +02:00
sample.lgorc merged my code in trunk, tried to do it with history conservation for xslt and 2007-07-31 09:02:39 +00:00

README

==========================================
libgo -- script to build library.gnome.org
==========================================


Installation
============

libgo is made to run from its checkout directory, there is no need for
installation.

configure and make are used to build translations.


Usage
=====

usage: lgo.py [options]

options:
  -h, --help            show this help message and exit
  -c CONFIG, --config=CONFIG
  -v, --verbose         verbosity level (more -v for more verbose)
  --rebuild=FILENAME    rebuild documentation from FILENAME
  --rebuild-all         rebuild all documents (even those that were already
                        built)
  --rebuild-language=LANGUAGE
                        rebuild all documents in LANGUAGE
  --skip-extra-tarballs
                        don't look for documentation extra tarballs

Example: python src/lgo.py -c sample.lgorc -v -v -v

Note about verbosity: xsltproc output is not redirected to /dev/null and will
amount for most of the output.


Configuration File
==================

lgo will look at ~/.lgorc, it can be overridden with -c.

sample.lgorc is a sample configuration file, src/defaults.lgorc lists all
variables and their default settings.

Notable configuration variables are:

 - ftp_gnome_org_local_copy: path to local copy of ftp.gnome.org, this is
   used not to download all the files that are already local.
 
 - download_cache_dir: path to download cache directory (default:
   ~/.lgo/cache/)

 - output_dir: path to web output (default: /var/www/library.gnome.org/)

 - version_min, version_max: minimum/maximum GNOME version to have
   documentation for (absolute minimum is 2.12.0).
   
   Note about versions:
    - libgo will only build the latest version of a serie,
    - libgo will only build the latest version of the latest development
      serie.

 - modules: list of modules to use (default: None, meaning all modules);
   this can be used to restrict modules to a specific subset, example:
   ['eog', 'gedit']
 
 - languages: list of languages to build (default: None, meaning all
   languages); this can be used to restrict languages to a specific subset,
   example: ['en', 'sv', 'ja', 'es']


System Requirements
===================

To build everything from 2.12 to current 2.19 development version :

 - disk usage:
   - download cache (everything from ftp.gnome.org): 829M
   - extracted files: 679M
   - web site: 624M
 
 - time:
   - building and scanning all documentation: 2h40
   - scanning (already built) documentation: 0h20


Mode of operation
=================

- Using http://ftp.gnome.org/pub/GNOME/teams/releng/ to download GNOME jhbuild
  modulesets for requested versions
- Iterating on versions
  - Downloading tarballs
    - Looking for gtk-doc or gnome-doc-utils usage in tarball
      - Building them
- Creating indexes