[kde-doc-english] Kubuntu documentation

[Yuri Chornoivan]

написане Tue, 04 Feb 2014 07:11:59 +0200, Valorie Zimmerman  
<valorie.zimmerman at gmail.com>:

> Hi Yuri and everybody,
>
> The time has come for us to get a docbook package from what we have so
> far on the wiki at http://userbase.kde.org/Kubuntu. We'll be using
> this package for testing, and do any last minute changes or additions
> as patches, as I understand it.
>
> Is the process to do this documented anywhere? Do we need to just turn
> it over to the team, or can we learn to do this ourselves?
>
> How are translations included in the package?
>
> Valorie
>
> PS: when we are closer to final release (April 17th) we will want to
> generate some Mediawiki -> HTML files for posting to our
> docs.kubuntu.org site. Is there a favored application to do this? -v

Hi,

Instructions for conversion (+HTML and other instructions):

http://userbase.kde.org/How_To_Convert_a_UserBase_Manual_to_Docbook

List of pages:

Kubuntu
Kubuntu/Welcome
Kubuntu/Installation
Kubuntu/Basic
Kubuntu/Advanced
Kubuntu/Software
Kubuntu/Contribute
Kubuntu/Support

Converted HTML with images:

https://dl.dropboxusercontent.com/u/55247264/kubuntu_HTML.tar.bz2

PDF version:

https://dl.dropboxusercontent.com/u/55247264/kubuntu.pdf

Hope this helps.

Best regards,
Yuri

>
> On Sun, Dec 8, 2013 at 9:26 PM, Yuri Chornoivan <yurchor at ukr.net> wrote:
>> написане Mon, 09 Dec 2013 02:31:20 +0200, Valorie Zimmerman
>> <valorie.zimmerman at gmail.com>:
>>
>>
>>> Hi folks, I know this is a bit unusual, but I'm writing to both the
>>> Doc team and web team simultaneously because the Kubuntu Doc team has
>>> a problem, and it is possible y'all can help us, if you are willing.
>>>
>>> Right now, we develop our documentation on the ubuntu wiki system,
>>> which is MoinMoin. This works well in that there is a low bar to entry
>>> for new folks, and errors can be fixed on the fly. Of course much of
>>> the documentation our users need is either on the Ubuntu system or the
>>> excellent KDE system, and much of our docs merely points or includes
>>> that material.
>>>
>>> There are problems as well. Moinmoin has no good system for exporting
>>> docs to Docbook so they can be included in the ISO, and there is no
>>> easy way to let translators help us internationalize once the
>>> documentation is complete and up-to-date.
>>>
>>> We wonder if it would be possible to move our wiki over to the KDE
>>> mediawiki system, with its wonderful translator helps. We could do
>>> this either as a standalone part of the system, sort of off to the
>>> side, or what we would prefer: be an actual part of Userbase, as part
>>> of /Distributions or similar.
>>>
>>> After translations are done, then perhaps we can get the help of the
>>> Doc team to get the Docbook magic done, so that we have the necessary
>>> packages to distribute to our users.
>>>
>>> A few of us have brought some of these ideas to the teams in IRC, but
>>> we're getting to the time in the release cycle where we have to make
>>> some decisions.
>>>
>>> What do you think?
>>>
>>> Valorie
>>
>>
>> Hi,
>>
>> I do not have any objections.
>>
>> If some help is needed with tweaking of conversion script (actually, I
>> promised to Kdenlive developers that it will work without any additional
>> user interaction and need to export xml, but it has not been happened  
>> yet ;)
>> ) or administration (I cannot change the user rights, but can delete and
>> move pages ;) ) I will try to help.
>>
>> Best regards,
>> Yuri