The new KDevelop manual

Jump to: navigation, search

Hi Claus, Because it is my first time editing and creating a wiki page, for me this experience is somehow in the blind. I have not understand the second paragraph or the way you want me to do it. You can show me and I can follow.

Actually is very difficult for a beginner to start writing new pages here (in the media wiki), because of the lack of guidance for beginners. Even for translation is even difficult to start with. I want to translate some pages here in this wiki for the Greek language and there is not such good guide to start reading with.

But my purpose for the kdevelop manual 5 is written in the email archive ...[[1]]

The idea is to be present the manual of kdevelop 4 and 5 but I will focus on the 5th version of kdevelop.

20:05, 28 August 2017

Hi Pfollas

Don't worry about the finer details of editing. Just start writing. It is easy enough to correct formatting mistakes; I usually patrol all new pages that I am aware of. You will get the hang of it as you go along.

As to translation I am happy to answer any questions you may have (and eventually include the material in a new introduction to translators).

We are aware that the guidance for writers and translators is not very good. Improving it is on our to do list. I should very much appreciate your feedback as work on the new introduction progresses. I have made a page for the Introduction to new contributors - nothing there yet, though. If you would like to follow the progress of that page, you can set a watch on the page and be notified whenever something changes there. And of course you are very welcome to contribute :-)

My question to you is about the new pages you have made about KDevelop5. I noticed that you took the contents of the equivalent KDevelop4 page and copied it with few modifications. That indeed seem to be a good way to get started. If you intend to proceed that way, I think we can actually employ a feature of the wiki software to transition existing translations along with the content. I wanted to know if it would be ok with you to do so; if so I can find out how to proceed and explain the process. The advantage of this way of doing it is that translators would only have to worry about stuff that is actually changed in the new manual.

05:25, 29 August 2017

Hi and sorry for the late answer. Yes I am interested and I would like you to show me how to do the procedure. Please give some guides about that feature of the wiki.

20:00, 7 September 2017

You do not have permission to edit this page, for the following reason:

The action you have requested is limited to users in one of the groups: Users, Administrators, trusted, KDEDevelopers.


You can view and copy the source of this page.

Return to Thread:User talk:Pfollas/The new KDevelop manual/reply (4).

ok, waiting for some guidance.

08:04, 9 September 2017

Hi Pfollas

It wasn't quite as simple as I had thought, but I have a solution now. When you want to move a page here is what you do:

  • Click on the red link to create the new page
  • Copy all of the contents of the KDevelop4 page and insert it into the new page
  • Change all occurrences of 'KDevelop4' and 'Kdevelop4' to 'KDevelop5'
  • Save and wait - please don't edit the new page yet

Now the new page needs to be entered into the translation system - that requires admin privileges. Just sit back and wait. Normally the new page will be handled the next day at the latest.

Before you start making any changes to the new page please check that the existing translations from the KDevelop4 page has been added to the new page. If I have missed the page feel free to contact me - I visit UserBase most days.

In order to discover this procedure I added the page Sessions and projects; it is ready to be edited. If you don't want to deal with this page right now, you may want to add the {{Construction}} template at the top of the page to notify readers, that the page is nor ready yet.

14:34, 9 September 2017

OK I will do it. Thanks.

20:50, 15 September 2017

Your instructions are

* Click on the red link to create the new page
*     Copy all of the contents of the KDevelop4 page and insert it into the new page
*     Change all occurrences of 'KDevelop4' and 'Kdevelop4' to 'KDevelop5'

(I have left the Kdevelop4 images files the same. I will do them later. right?)

*     Save and wait - please don't edit the new page yet 

(What do you mean here?? Just Save and publish or only Save?)

21:05, 15 September 2017

You have done exactly as I proposed :-). I shall now make your new page translatable and transfer the existing translations. Then you can edit the page further.

Edit: The deed is done - feel tree to edit!

07:49, 16 September 2017

OK,thanks, I will do the other pages so I can finish the move from documentation 4 to 5, and then start editing. Could you help me with this? How to add Greek Translation? I have not understand how to be a translator? and What the tags means for translation? And Imagine I have read the relative documents here and I found them fuzzy. :(

10:08, 16 September 2017

I can transfer all the pages if you wish.

As to translations: Now that you have translators rights there should be a few more links in the right hand side of under the heading of "Translators" (or something similar - if you have set your language to Ελληνικά the strings may have been translated). Now click the link "Start Translating". You may need to enter your language code in the box at the top of the page (el for greek). Now you will see a long list of translatable pages. Click on one, and you will be taken to the translation tool with this page loaded.

Now start translating :-) You don't have to translate a whole page in one go - you can always return and continue working on a page.

You will notice that the translation tool gives you small sections at a time. The way the translate system works every page is split into small translation units. This makes your life a lot easier once you have translated some pages and the contents of one of them is modified: The system will show you which units have been modified. You only have to revisit the modified units to keep your translations up to date.

Happy translating :-)

Before you proceed it is probably a good idea

07:53, 17 September 2017

yes, if you can transfer all the pages easier, please do it. I will be away the next two weeks for my vacations, so I will be away from computer or any device. My next step is :

to merge the docbook ,that exists in git for kdevelop, with this wiki kdevelop manual 5. The developers have updated that docbook and not the wiki so the docbook is updated than the wiki. 

I noticed that the docbook is xml. Is there any way to remove the xml tags and see it like a normal page? Or produce it in a readable format?

I will start translating too. Thanks.

19:40, 19 September 2017