- [View source↑]
- [History↑]
Contents
Thread title | Replies | Last modified |
---|---|---|
Create version (copy) of the manual | 15 | 18:25, 17 November 2019 |
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.
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).
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.
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.
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.
<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?