Hi Massimo! > Plesse help me understanding Rest&Sphinx
ReST is a plaintext markup that is really easy to use. To better understand, give it a try with the on-line tool called "reStructuredText to Anything" [http://rst2a.com/]: in the main page, choose "create" and then "type a document", and you'll get an idea. To get help with the ReST rules see [http://sphinx.pocoo.org/rest.html] "reStructuredText Primer" (wich itself is written in ReST) documentation about paragraphs, lists, and almost all the markup. > Can we generate also a pdf Rest&Sphinx? Yes! > can we integrate existing documentation in c\harbour\doc? The documentation right in /harbour/doc, like cmdline.txt for example, is almost in ReST style. But for the documentation in /harbour/doc/hb_api.txt for example, we (I can try it) should write a tool to help us with all the $xxxx$ markup. > Which is first step? First, install Python 2.6 (in MS-Windows you have a "next, next, finish" style installer). If you're under unix/linux/mac you probably already have python installed. Then install sphinx. Follow that recipe: 1. Download and install python 2.6; 2. Download the Python Setup Tools package from [http://pypi.python.org/pypi/setuptools]. In the end of the page choose the file ``setuptools-0.6c11.win32-py2.6.exe``. If you are under linux/mac google for "python setup tools" and "easy_install" for your platform; 3. Use easy_install to install sphinx like "easy_install sphinx". Easy that way! To get help how to start a documentation project see [http://sphinx.pocoo.org/intro.html] on topic "Setting up the documentation sources". > we can follow your way using Rest&Sphinx becase we not have jet any valid > way I can (and want to) help with it :-) > i suggest you subscribe developer mailing list > can try with a little part of harbour I'm already subscribed! And yes we can try it with a small chunk and present the work to the community. Best regards! -- Daniel Gonçalves Base4 Sistemas Ltda. [www.base4.com.br] [twitter.com/spanazzi] _______________________________________________ Harbour-users mailing list (attachment size limit: 40KB) [email protected] http://lists.harbour-project.org/mailman/listinfo/harbour-users
