cayenne-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Christian Grobmeier <grobme...@gmail.com>
Subject Re: docbook
Date Sun, 29 May 2011 09:48:22 GMT
I have just asked for the licenses for Andrus, Aristedes and Michael
(no other responses).
WIll let you know about the next steps when I have info.

Cheers


On Thu, May 26, 2011 at 2:57 PM, Andrus Adamchik <andrus@objectstyle.org> wrote:
> Here is the list of committers with Apache IDs:
>
> http://cayenne.apache.org/contributors.html
>
> At least aadamchik and amaniatis will need this. Anyone else?
>
> Andrus
>
> On May 26, 2011, at 1:31 AM, Christian Grobmeier wrote:
>
>>> By far the best tool for writing docbook is Oxygen. We have had an offer for
>>> free licenses for the Cayenne committers, should we go down the docbook
>>> path.
>>
>> Thats correct - I just need to know the full names and apache ids to
>> request the Oxygen licenses.
>>
>> Cheers,
>> Christian
>>
>>
>>>
>>> I've tried some html to docbook converters, but the effort to clean up the
>>> result was about equal to the effort in just copying the text over by hand.
>>>
>>> The thing with docbook is that there are 10 ways to do anything. We need to
>>> write our own style guide for the choices we make and keep it consistent.
>>> For example, there are about 6 different types of list.
>>>
>>> Ari
>>>
>>>
>>>
>>> On 26/05/11 10:05 AM, Andrus Adamchik wrote:
>>>>
>>>> Hi Ari,
>>>>
>>>> Very nice! I may try to continue writing 3.1 docs in a couple of days.
>>>> Since I will be on the plane and offline during that period, I'll probably
>>>> try to buy a PDF edition of Definitive Guide
>>>> (http://docbook.org/tdg5/en/html/docbook.html ) from OReilly.
>>>>
>>>> Also are there any recommended editors for Docbook XML? (I'd hate to
>>>> manually escape code chunks).
>>>>
>>>> Andrus
>>>>
>>>> On May 9, 2011, at 4:11 AM, Aristedes Maniatis wrote:
>>>>
>>>>> I realise I should have mentioned this to the dev list.
>>>>>
>>>>> Quick guide
>>>>>
>>>>> 1. svn up
>>>>> 2. cd main/trunk/docs/docbook/
>>>>> 3. mvn site
>>>>> 4. wait for maven to download the internet
>>>>> 5. open main/target/...
>>>>>
>>>>> Both PDF and html are generated.
>>>>>
>>>>> Ari
>>>>>
>>>>>
>>>>>
>>>>> -------- Original Message --------
>>>>> Subject: svn commit: r1098308 - in /cayenne/main/trunk/docs/docbook:
./
>>>>> css/ main/ main/src/ main/src/images/ stylesheets/
>>>>> Date: Sun, 01 May 2011 14:07:03 -0000
>>>>> From: amaniatis@apache.org
>>>>> Reply-To: dev@cayenne.apache.org
>>>>> To: commits@cayenne.apache.org
>>>>>
>>>>> Author: amaniatis
>>>>> Date: Sun May  1 14:07:02 2011
>>>>> New Revision: 1098308
>>>>>
>>>>> URL: http://svn.apache.org/viewvc?rev=1098308&view=rev
>>>>> Log:
>>>>> A very rough first cut of the docbook build scripts. This does a few
>>>>> things:
>>>>>
>>>>> 1. Builds the pdf and html docs when you execute "mvn site"
>>>>> 2. Obliterates the ugly and annoying default maven site behaviour
>>>>> 3. Applies style sheets, css, etc
>>>>> 4. Sets up some reasonable defaults for TOC and other styling
>>>>>
>>>>> What isn't done yet is pulling across more than just a few pages of
>>>>> sample docbook. This will take lots of effort
>>>>> And of course, making it more attractive, which can wait until later.
>>>>>
>>>>> I've put in some sample docbook elements which are interesting: lists,
>>>>> sections, link and xref, code snippets.
>>>>>
>>>>> This module has not yet been tied into the main Cayenne pom and it is
in
>>>>> a folder location designed to keep out of the way of the existing
>>>>> documentation. When it is complete, we can move it into a better location.
>>>>>
>>>>
>>>
>>> --
>>> -------------------------->
>>> Aristedes Maniatis
>>> GPG fingerprint CBFB 84B4 738D 4E87 5E5C  5EFA EF6A 7D2E 3E49 102A
>>>
>>
>>
>>
>> --
>> http://www.grobmeier.de
>>
>
>



-- 
http://www.grobmeier.de

Mime
View raw message