openoffice-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Matthias Seidel <matthias.sei...@hamburg.de>
Subject Re: Trying to re-generate the Documentation effort
Date Sat, 13 Jun 2020 18:08:54 GMT
Hi Francis,

Am 13.06.20 um 19:46 schrieb F Campos Costero:
> Hi Keith,
> I have been playing with DocBook and it certainly takes a while to learn. I
> suspect that once it was figured out, it would be a workable way to produce
> documents in various formats. I say that based on the progress I made in
> about a week starting from zero knowledge. I am, however, still struggling
> and it is not an easy path.
>  I have two questions at the moment. The second one is really for anyone.
> 1. I do not see a way  to publish to MediaWiki from DocBook. I thought you
> mentioned there is an extension and I fear I am being stupid but I am not
> finding it. Can you point me in the right direction?
> 2. My AOO 4.2.0 version does not include the DocBook format in the Save As
> dialog from Writer. I rolled back to 4.1.7 and used that. Is there a known
> reason for 4.2.0 to be lacking that option?
I don't know what version you are using, but in my Test Builds of 4.2.0
I can definitely save as "DocBook (.xml)" in Writer.
>
> In general, I really like the idea you present of having the document
> production based on Writer. Allowing new people to contribute immediately
> should greatly lower a barrier to recruitment. To adopt that strategy we
> have to demonstrate the viability of Writer -> MediaWiki transfers. Is
> there anyone with the knowledge and time to look at the Wiki Publisher
> extension? I think we have to get that question clearly posed and  answered
> so we know whether that approach can be considered.

MediaWiki Extension is broken for so long now it would be really great
if someone could have a look at it...

Regards,

   Matthias

>
> Regards,
> Francis
>
> On Sat, Jun 13, 2020 at 10:14 AM Keith N. McKenna <keith.mckenna@comcast.net>
> wrote:
>
>> On 6/13/2020 5:05 AM, Matthias Seidel wrote:
>>> Hi Keith,
>>>
>>> Thank you for your effort!
>>>
>>> I found some typos:
>>>
>>> "Apace" should be "Apache"
>>>
>>> "Anaysis" should be "Analysis" (in file properties)
>>>
>>> Regards,
>>>
>>>    Matthias
>> Thanks Matthias;
>>
>> Thought I had got all those in the source.
>>
>> Keith
>>> Am 13.06.20 um 01:42 schrieb Keith N. McKenna:
>>>> On 6/3/2020 9:11 AM, Keith N. McKenna wrote:
>>>>> On 5/30/2020 8:41 PM, Keith N. McKenna wrote:
>>>>>> I should probably have my head examined but I am thinking of one
more
>>>>>> time trying to revive the documentation effort for AOO. One of the
>>>>>> drawbacks is that most people that have started to help have left
as
>>>>>> there has been very limited availability of mentoring. I do not see
>> this
>>>>>> changing but I am hoping that by defining a new process we can reduce
>>>>>> the dependency on mentoring.
>>>>>>
>>>>>> One idea for this would require that the MediaWiki extension be made
>>>>>> functional again. This would allow for using Writer to create the
>> source
>>>>>> which could be stored in the git repository and then be transferred
to
>>>>>> the mwiki for easy online access. By storing the source in the
>>>>>> repository it would give us better revision control over the
>>>>>> documentation. Plus it may help relieve the mentoring problem as
many
>>>>>> more people are familiar with using Writer.
>>>>>>
>>>>>> Another would be to use Docbook, though this is not as appealing
as I
>>>>>> have no familiarity with it and it appears that there is a steep
>>>>>> learning curve to its use and that would be a disadvantage to
>> attracting
>>>>>> new people.
>>>>>>
>>>>>> I look forward to any other suggestions that could move this effort
>>>>>> along as it has languished for far to long.
>>>>>>
>>>>>> Regards
>>>>>> Keith
>>>>>>
>>>>> AS part of this effort I am working on a document laying out What I see
>>>>> as the need for this project and a number of alternatives that could
be
>>>>> used to to address those needs. Once completed I will share it both
>> here
>>>>> and on doc@for more comments and suggestions.
>>>>>
>>>>> Thanks to all who have responded for there time and suggestions
>>>>>
>>>>> Regards
>>>>> Keith
>>>>>
>>>> As promised the document is ready to be shared. There are tow versions,a
>>>> ODT file and a PDF one that can be downloaded from the following link
>>>> https://1drv.ms/f/s!AsMYmStvrJNJin9GvgxRst1AMk2c. There are Two
>>>> versions, PDF and ODT just pick the one you want and download it. All
>>>> comments and suggestions are welcome.
>>>>
>>>> I am also going to be starting a thread over on doc@ to try and solicit
>>>> from there as well.
>>>>
>>>> Regards
>>>> Keith
>>>>
>>
>>


Mime
View raw message