[Pkg-owncloud-commits] [owncloud-doc] 27/49: Improve README

David Prévot taffit at moszumanska.debian.org
Fri Jan 17 02:41:31 UTC 2014


This is an automated email from the git hooks/post-receive script.

taffit pushed a commit to branch master
in repository owncloud-doc.

commit e151ee5f6f0c1add1b73538a35b09aa1148caf1b
Author: Daniel Molkentin <daniel at molkentin.de>
Date:   Mon Jan 6 17:40:48 2014 +0100

    Improve README
---
 README.rst | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/README.rst b/README.rst
index bef4585..ff5fa19 100644
--- a/README.rst
+++ b/README.rst
@@ -28,13 +28,28 @@ At this point, this repository hosts three manuals:
 
 Building
 --------
+
+Linux / OS X
+^^^^^^^^^^^^
+
 First make sure that these things are installed
- - Python 2
+ - Python 2 (2.6.0 or better, Python 3 is not yet supported!)
  - Sphinx (e.g. sudo yum install python-sphinx), on Mac: ``sudo easy_install Sphinx``
- - Sphinx PHPDomain (e.g. ``sudo pip install sphinxcontrib-phpdomain``)
+ - Sphinx PHPDomain (e.g. ``sudo easy_install sphinxcontrib-phpdomain``)
+ - rst2pdf (e.g. ``sudo easy_install rst2pdf``)
  - If you're on Arch Linux, the build script is called sphinx-build2 which will fail. Therefore you have to provide a link::
 
      sudo ln -s /usr/bin/sphinx-build2 /usr/bin/sphinx-build
 
 then enter any manual directory, then run ``make html``. The result can be found in the ``_build/html`` subdirectory.
+PDFs can be build with the ``make latexpdf`` command and found 
+
+Windows
+^^^^^^^
+
+Running ``setup.cmd`` will install Python 2.7 and install all dependencies.
+
+Enter any manual and clicking the "Build HTML" shortcut will create a HTML build. Likewise, "Build PDF" will build the
+PDF using the more lightweight, but feature-incomplete RST2PDF tool. The results are in ``_build/html`` and  ``_build/pdf``
+respectively.
 

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-owncloud/owncloud-doc.git



More information about the Pkg-owncloud-commits mailing list