[kde-doc-english] Kubuntu documentation

[Valorie Zimmerman]

Reply inline.

On Tue, Feb 4, 2014 at 12:31 AM, Yuri Chornoivan <yurchor at ukr.net> wrote:
> написане 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

Hi Yuri, we have a couple of questions. First, How does one get
translations? Same procedure? If so, is there a script already
fetching all translations of a set of pages?

You mentioned in your first offer to help that there is a goal of
having a conversion script which needs no tweaking. Did you have to
change things for us? If so, where is that "tweaked" script?

Valorie


>> 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

-- 
http://about.me/valoriez