Difference between revisions of "Generating documentation"

From Dreamwidth Notes
Jump to: navigation, search
(New page: These instructions are based on the ones given in the [http://www.dwscoalition.org/show_bug.cgi?id=84 bug report]. First, you will want to install some necessary packages if you don't hav...)
 
(+caveat that this is old server-side LJ code docs; +symlink docbook-xsl so generate.pl can find it)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
These instructions are based on the ones given in the [http://www.dwscoalition.org/show_bug.cgi?id=84 bug report].
+
Dreamwidth inherited from Livejournal a system for building server-side documentation about how the codebase works.  However, these docs haven't been kept up to date; there is more, and much more recent, documentation on this wiki.
 +
 
 +
However, if for some reason you want to try and build some docs which describe how the LJ code worked long ago, you can try the following steps, though it may be difficult to get it to work.
 +
 
 +
 
 +
These instructions are based on the ones given in the [http://bugs.dwscoalition.org/show_bug.cgi?id=84 bug report].
  
 
First, you will want to install some necessary packages if you don't have them already:
 
First, you will want to install some necessary packages if you don't have them already:
  
  sudo apt-get install docbook-xml xsltproc
+
  sudo apt-get install docbook-xml xsltproc docbook-xsl
  
The first time to generate, use this command:
+
Symlink the docbook xsl provided by the Debian/Ubuntu package to the place where <tt>generate.pl</tt> expects to find it:
  
  $LJHOME/doc/raw/build/generate.pl --getxsl
+
  ln -s /usr/share/xml/docbook/stylesheet/docbook-xsl/ $LJHOME/doc/raw/build/ xsl-docbook
  
After that, you can use:
+
You can then generate it with:
  
 
  $LJHOME/doc/raw/build/generate.pl
 
  $LJHOME/doc/raw/build/generate.pl
 +
 +
Note: it used to be possible to download the docbook xsl using the <tt>--getxsl</tt> flag, but the repository where it was hosted has since gone offline. Fortunately, there are compatible packages in debian and ubuntu :)
  
 
[[Category: Dreamwidth Installation]]
 
[[Category: Dreamwidth Installation]]

Latest revision as of 01:04, 11 March 2013

Dreamwidth inherited from Livejournal a system for building server-side documentation about how the codebase works. However, these docs haven't been kept up to date; there is more, and much more recent, documentation on this wiki.

However, if for some reason you want to try and build some docs which describe how the LJ code worked long ago, you can try the following steps, though it may be difficult to get it to work.


These instructions are based on the ones given in the bug report.

First, you will want to install some necessary packages if you don't have them already:

sudo apt-get install docbook-xml xsltproc docbook-xsl

Symlink the docbook xsl provided by the Debian/Ubuntu package to the place where generate.pl expects to find it:

ln -s /usr/share/xml/docbook/stylesheet/docbook-xsl/ $LJHOME/doc/raw/build/ xsl-docbook 

You can then generate it with:

$LJHOME/doc/raw/build/generate.pl

Note: it used to be possible to download the docbook xsl using the --getxsl flag, but the repository where it was hosted has since gone offline. Fortunately, there are compatible packages in debian and ubuntu :)