User talk:Danders

Hi, I'd like to make a "release" of this manual concurrent with the release of Plan, but using docbook would be a lot of hassle and not optinal.

Is it possible to create a copy (v1 or somthing)?

This would make it possible to fix errors and missing things in v1, while new features can be added to existing docs.

Danders (talk)

Hi,

Yes, it is possible.

What format do you prefer?

1. It is possible to export pages for archiving:

https://userbase.kde.org/Special:Export

2. We can create a PDF file from Plan doc pages. But how can user find and read it?

You can link the UserBase pages directly from org.kde.calligraplan.desktop as it is done now (but it will be more user-friendly to link the translated version):

X-DocPath=https://userbase.kde.org/Special:myLanguage/Plan

Personally, I think it is easy enough to create more or less current-state-of-art docbook (I can do it if you want) and package it as an offline documentation anyway (just my 2 cents).

Yurchor (talk)

I was thinking of an *online* version, like Plan/Manual/v1 with all subpages which can be updated continously (like a branch in git). This would be the most flexible way for me. This is one reason for not going docbook, another is that it does not work out of the box, I have tried. I think I need to rewrite some stuff, an/or update docbook generator to make it work.

Danders (talk)

Ok. So what kind of help do you need?

Just move all the current Plan/Manual/... pages into Plan/Manual/.../v1 ? Automatic copying cannot be done with the current wiki setup. Only moving is possible.

Thanks in advance for your answer.

Yurchor (talk)

Well, I think I will postpone this to later as it is not easily supported. (I think there are an extension available that does this, but...)

You are of course very wellcome to try to create a docbook. When I tried it choked on % chars both in text and formatting, and also I didn't get any easily usable chapter/section info that I could use for context help.

Another posibility is if one can export to html and put it on docs.kde.org. If that is easy to do, it would solve my most important problem.

Thanks for your help.

Danders (talk)

1. Yes, DocBook is a limited format. Should I try to fix the script/Plan pages and create the docbook that will be acceptable according to your requirements?

2. No. It is not possible to place the docs on d.k.o without a docbook. Sorry.

Yurchor (talk)

<quote> You can link the UserBase pages directly from org.kde.calligraplan.desktop as it is done now (but it will be more user-friendly to link the translated version):

X-DocPath=https://userbase.kde.org/Special:myLanguage/Plan </quote>

I don't think this works? How can the wiki figure out the language I want?

Danders (talk)

This works. By your browser locale.

Yurchor (talk)

Ahhh, well, I'll take your word for it :), it does not work for me. I have danish in my browser, but just get english in all userbase pages.

Danders (talk)