[TYPO3-doc] srv123 and preview server: files, urls, building

[Xavier Perseguers]

Hi,

> Normally we are using Sphinx
> ============================
> in general we are just using the latest Sphinx version. It is version
> 1.2pre which I fetch using 'hg'. Its located in
>    file:///home/mbless/HTDOCS/01-server-setup-howto/4-sphinx/sphinx
> 
> http://srv123.typo3.org/~mbless/01-server-setup-howto/4-sphinx/sphinx/
> 
> To install such a Sphinx version, you have to do:
>    cd /home/mbless/HTDOCS/01-server-setup-howto/4-sphinx/sphinx
>    sudo python setup.py install

I still found something suboptimal but maybe I'm wrong. IIRC you modify
the default Sphinx parser to add support for the special tables you used
as additional definition in reST. Is this possible to NOT modify the
default parser but use modules are whatever in Sphinx that we could have
in the Git repository instead?

It's just that installing and configuring Sphinx for developers is not
totally trivial (it's not that complicated I agree but still) but
modifying the parser is something I really don't feel confident with,
moreover if we want to benefit from updates.

Maybe I'm slightly wrong here but anyway... Perhaps adding such
information in the existing pages on wiki.typo3.org would be a good idea
now that the whole chain is more or less "stable".

Cheers

-- 
Xavier Perseguers
Release Manager TYPO3 4.6

TYPO3 .... inspiring people to share!
Get involved: http://typo3.org