[TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-20 Thread Xavier Perseguers
Dear TYPO3 enthusiasts, Dear TYPO3 developers, You cannot ignore that OpenOffice manuals are not the way to go anymore. We are still in the process of smoothing a few edges (such as a proper integration with typo3.org) but basically as 95% is already working, you should consider switching to

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-21 Thread Dmitry Dulepov
Hi! Xavier Perseguers wrote: You may find useful resources to do so in the TYPO3 wiki [1] but to be honest, as of today, this describes the relative *hard way* to switch to this new format since it shows you how to install a complete environment from scratch. Authors need really good reasons t

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-21 Thread Georg Ringer
Am 21.08.2013 09:40, schrieb Dmitry Dulepov: > What benefits do *authors* have from using the new system? I am > interested in that as author of several extensions. What good would the > new system do for me? If there is nothing, why would I switch? - you have no hassles with strange styles happen

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-21 Thread Xavier Perseguers
Hi Dmitry, > Xavier Perseguers wrote: >> You may find useful resources to do so in the TYPO3 wiki [1] but to be >> honest, as of today, this describes the relative *hard way* to switch to >> this new format since it shows you how to install a complete environment >> from scratch. > > Authors need

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-21 Thread Patrick Schriner
Hello, Thanks for the work! Quick question: Is there any plan to integrate the docs better into the TER? I find it a good bit odd that I have to follow four links from the extension to it's manual on docs.typo3.org (e.g. with news). Regards, Patrick On Tue, 20 Aug 2013 14:37:58 +0200, Xav

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-21 Thread François Suter
Hi, but not as "main points" since I agree this is more a point from a "developer" pov. All that has been said is true, I slightly disagree with that last point: I have found it much more enjoyable to write with reST than with some bloody word processor. Of course that's a question of taste,

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-21 Thread Stephen Bungert
Are there any screenshots of what this mark up looks like? I have never heard of REST. Also is there away to convert existing OOo manuals to this new format... I have some pretty long manuals... I really don't want to have to write them by hand in the new format. Do still package the documentat

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-21 Thread Kari Salovaara
http://sphinx-doc.org/index.html On 08/21/2013 01:47 PM, Stephen Bungert wrote: Are there any screenshots of what this mark up looks like? I have never heard of REST. Also is there away to convert existing OOo manuals to this new format... I have some pretty long manuals... I really don't want t

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-21 Thread Georg Ringer
Hi, if you got a link like https://github.com/TYPO3-extensions/TYPO3v4-Extensions-news/tree/master/Documentation > upper right corner > show source georg ___ TYPO3-english mailing list TYPO3-english@lists.typo3.org http://lists.typo3.org/cgi-bin/mailma

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-21 Thread Georg Ringer
damn, link: http://docs.typo3.org/typo3cms/extensions/sphinx/latest/AdministratorManual/UsingSphinxCommandLine/Index.html ___ TYPO3-english mailing list TYPO3-english@lists.typo3.org http://lists.typo3.org/cgi-bin/mailman/listinfo/typo3-english

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-21 Thread Xavier Perseguers
Hi Stephen, Stephen Bungert wrote: > Are there any screenshots of what this mark up looks like? I have never > heard of REST. Go to any manual on docs.typo3.org, example: http://docs.typo3.org/typo3cms/extensions/sphinx/latest/ navigate in any chapter and click on "Show Source" top on the righ

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-21 Thread Xavier Perseguers
> heard of REST. Also is there away to convert existing OOo manuals to this > new format... I have some pretty long manuals... I really don't want to have > to write them by hand in the new format. Here's a screenshot of the wizard to convert OOo manuals to Sphinx projects: http://docs.typo3.or

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-21 Thread Olivier Dobberkau
Am 21.08.13 10:42, schrieb Patrick Schriner: > Quick question: Is there any plan to integrate the docs better into the > TER? http://forge.typo3.org/issues/50542 olivier ___ TYPO3-english mailing list TYPO3-english@lists.typo3.org http://lists.typo3.or

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-23 Thread Dmitry Dulepov
Hi! Georg Ringer wrote: - it is very easy to contribute to documentation as it is textbased How does editing look like? For example, if I want to insert the table, in OO I just insert the table. How does it happen in the new system? Is it same easy (one menu item in some editor)? -- Dmitry

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-23 Thread Georg Ringer
Hi, http://docs.typo3.org/typo3cms/extensions/news/Main/Configuration/Reference/Index.html > top right corner > "show source" georg ___ TYPO3-english mailing list TYPO3-english@lists.typo3.org http://lists.typo3.org/cgi-bin/mailman/listinfo/typo3-englis

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-23 Thread d.ros
Am 23.08.2013 09:43, schrieb Dmitry Dulepov: Hi! Georg Ringer wrote: - it is very easy to contribute to documentation as it is textbased How does editing look like? For example, if I want to insert the table, in OO I just insert the table. How does it happen in the new system? Is it same easy

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-23 Thread Xavier Perseguers
Hi, >> - it is very easy to contribute to documentation as it is textbased > > How does editing look like? For example, if I want to insert the table, Georg Ringer wrote: > Hi, > > http://docs.typo3.org/typo3cms/extensions/news/Main/Configuration/Reference/Index.html >> top right corner > "show

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-23 Thread Xavier Perseguers
Hi David, > This is a peek of a table > http://docs.typo3.org/typo3cms/extensions/news/stable/_sources/Index.txt This is a Sphinx property table, something special, just as is the TS table Georg referenced, something that is coming from TYPO3 Documentation Team and that we think (after a while) i

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-23 Thread Georg Ringer
Hi, oh boy a love that georg ___ TYPO3-english mailing list TYPO3-english@lists.typo3.org http://lists.typo3.org/cgi-bin/mailman/listinfo/typo3-english

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-24 Thread Peter Linzenkirchner
Hello Xavier, i installed the extension in a typo3 6.1 introduction package and was able to follow the steps in the video with the demo project (demo-sphinx). But when i try to write a documentation for one of my extensions i miss something: The backend module "Sphinx Console" shows me only t

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-24 Thread Xavier Perseguers
Hello Peter, > i installed the extension in a typo3 6.1 introduction package and was able to > follow the steps in the video with the demo project (demo-sphinx). But when i > try to write a documentation for one of my extensions i miss something: > > The backend module "Sphinx Console" shows m

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-24 Thread Peter Linzenkirchner
Hello Xavier, > The module Sphinx Console is based on the Filelist module. As such one > way (that I did not test) would be to define another file storage record > (for FAL) at the root of your website (pid 0) with Web > List. This way > you would then see your extensions as well. thanks for you

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-24 Thread Xavier Perseguers
Hello Peter, > Show "Documentation Static" works, but Show Documentation Interactive throws > the following error: > > Cannot build Sphinx project: > --- snip --- > copying static files... done > > Exception occurred: > File > "/Users/peter/Sites/typo3_61/typo3conf/ext/sphinx/Resources/Priv

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-24 Thread Peter Linzenkirchner
Hallo Xavier, Please open a ticket in bug tracker (one from "sphinx") and > describe exactly how to reproduce (kickstart here, compile there, ...). done: http://forge.typo3.org/issues/51317 > No, the "/Localization./" folder is just a way for us to see > that localization is present with no ri

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-25 Thread Peter Linzenkirchner
Hello, in order to close this topic: it was my fault because i installed an older version of sphinx (1.0.0) instead of the actual 1.1.2. There is no error with the actual version. Thanks Xavier for your patience Peter Am 24.08.2013 um 21:33 schrieb Peter Linzenkirchner : > Hallo Xavier, >

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-25 Thread Christian Platt
Hi Dimitry, when looking forward to 6.x i also had a look for editing those documentation files. Just check out https://notex.ch there is an online editor for those files... it looks as if this is an python based service, where you can edit and download files. Christian Am 26.08.2013 um 07:2

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-25 Thread Xavier Perseguers
Hi Dmitry, > Xavier Perseguers wrote: >> No, reStructuredText is text-based and there are currently no good >> graphical editor for this (check the wiki [1] if you want to use one >> anyway). >> >> You should think of it as when writing HTML in the old days. Then we got >> HTML editors and after a

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-25 Thread François Suter
Hi Dmitry, What was the reason behind the change? Was it a hope that extension authors will rush to learn a new syntax and be happy to write docs using tags instead of a word processor? :) I recently answered another unhappy fellow with the explanation of the reasons. Please read: http://fo

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-26 Thread Xavier Perseguers
Hi, > François Suter wrote: >> And yes, I certainly expect developers to be happier with reST than >> OpenOffice. Once they get over their resistance to change ;-) > > This is the view from just one side and for the doc team it is obviously > an advantage :) I asked what advantages extension auth

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-27 Thread Peter Linzenkirchner
Hello Xavier, i tried to upload an extension of mine with a new reST documenation, but it doesn`t work: http://typo3.org/extension-manuals/socialshareprivacy/1.2.5/view/ The TER shows the old open office documentation. In docs.typo3.org the manual should be reachable with this url: http://d

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-28 Thread Philipp Gampe
Hi Peter, Peter Linzenkirchner wrote: > did i miss something? AFAIK TER does not link to the new docs yet. You might also ask in the documentation list for help, e.g. ask Martin to activate your extension. Best regards -- Philipp Gampe – PGP-Key 0AD96065 – TYPO3 UG Bonn/Köln Documentation – A

Re: [TYPO3-english] Bye-bye OpenOffice, welcome ReST

2013-08-29 Thread Peter Linzenkirchner
Hi Philipp, thanks for your answer - i found the reason on the documentation list: http://forum.typo3.org/index.php?t=msg&th=198830&goto=693167&#msg_693167 i have to wait a few days :-) Peter -- Xing: http://www.xing.com/profile/Peter_Linzenkirchner Web: http://www.typo3-lisardo.de Facebook: