PDF version of manual gives 404 error

[Harry Henry Gebel]

Hi,

I am trying to download the PDF version of the Digikam manual. When I
follow the link from the Digikam website
(http://docs.kde.org/development/en/extragear-graphics/digikam/digikam.pdf)
in Firefox I get a blank page, when I try to download it I get a 404
file not found error. The Showfoto and Kipi-plugins PDFs download
fine.

As an alternative, where can I download the documentation for the Kde
Help Center? I compiled from the 1.9.0 tarball, but it didn't install
the documentation. I am using the documentation at
http://docs.kde.org/development/en/extragear-graphics/digikam/index.html
but it is not very user friendly, specifically it no next or previous
page links. It has at the bottom of the page the name of the next and
last page, but the names aren't links.

-Harry
_______________________________________________
Digikam-users mailing list
[hidden email]
https://mail.kde.org/mailman/listinfo/digikam-users

[Gilles Caulier-4]

2011/3/3 Harry Henry Gebel <[hidden email]>:
> Hi,
>
> I am trying to download the PDF version of the Digikam manual. When I
> follow the link from the Digikam website
> (http://docs.kde.org/development/en/extragear-graphics/digikam/digikam.pdf)
> in Firefox I get a blank page, when I try to download it I get a 404
> file not found error. The Showfoto and Kipi-plugins PDFs download
> fine.

It due to recent subversion to Git migration. It will be solved soon
by KDE team.

>
> As an alternative, where can I download the documentation for the Kde
> Help Center? I compiled from the 1.9.0 tarball, but it didn't install
> the documentation. I am using the documentation at
> http://docs.kde.org/development/en/extragear-graphics/digikam/index.html
> but it is not very user friendly, specifically it no next or previous
> page links. It has at the bottom of the page the name of the next and
> last page, but the names aren't links.

Documentation repository is there :

https://projects.kde.org/projects/extragear/graphics/digikam/digikam-doc/repository

Gilles Caulier
_______________________________________________
Digikam-users mailing list
[hidden email]
https://mail.kde.org/mailman/listinfo/digikam-users

[Harry Henry Gebel]

Thanks for you fast and helpful reply!

-Harry

>
> It due to recent subversion to Git migration. It will be solved soon
> by KDE team.
>
>
> Documentation repository is there :
>
> https://projects.kde.org/projects/extragear/graphics/digikam/digikam-doc/repository
>
> Gilles Caulier

_______________________________________________
Digikam-users mailing list
[hidden email]
https://mail.kde.org/mailman/listinfo/digikam-users

[Gilles Caulier-4]

If PDF file is not restored in the future, please contact KDE i18n
team which manage scripts to generate PDF from docbook files...

Gilles Caulier

2011/3/5 Harry Henry Gebel <[hidden email]>:

> Thanks for you fast and helpful reply!
>
> -Harry
>
>>
>> It due to recent subversion to Git migration. It will be solved soon
>> by KDE team.
>>
>>
>> Documentation repository is there :
>>
>> https://projects.kde.org/projects/extragear/graphics/digikam/digikam-doc/repository
>>
>> Gilles Caulier
> _______________________________________________
> Digikam-users mailing list
> [hidden email]
> https://mail.kde.org/mailman/listinfo/digikam-users
>

_______________________________________________
Digikam-users mailing list
[hidden email]
https://mail.kde.org/mailman/listinfo/digikam-users

[Harry Henry Gebel]

Is that also who I contact if I want to contribute updates to the manual?

On Sat, Mar 5, 2011 at 2:02 AM, Gilles Caulier <[hidden email]> wrote:

> If PDF file is not restored in the future, please contact KDE i18n
> team which manage scripts to generate PDF from docbook files...
>
> Gilles Caulier
>
> 2011/3/5 Harry Henry Gebel <[hidden email]>:
>> Thanks for you fast and helpful reply!
>>
>> -Harry
>>
>>>
>>> It due to recent subversion to Git migration. It will be solved soon
>>> by KDE team.
>>>
>>>
>>> Documentation repository is there :
>>>
>>> https://projects.kde.org/projects/extragear/graphics/digikam/digikam-doc/repository
>>>
>>> Gilles Caulier
>> _______________________________________________
>> Digikam-users mailing list
>> [hidden email]
>> https://mail.kde.org/mailman/listinfo/digikam-users
>>
> _______________________________________________
> Digikam-users mailing list
> [hidden email]
> https://mail.kde.org/mailman/listinfo/digikam-users
>

_______________________________________________
Digikam-users mailing list
[hidden email]
https://mail.kde.org/mailman/listinfo/digikam-users

[Gilles Caulier-4]

It's me.

A lots of people have works on handbook in the past. But, since a long
time, it's have not be updated. Last updated date around 1.1 or 1.2
release, if i'm not too wrong...

Handbook, of course, need to be updated for future 2.0 release,
including new feature, and also, 1.x missing in current documentation.

Handbook do not use a wiki page to be written. It use docbook syntax
(XML like code). It's not complex to understand.

docbook can be converted to HTML, to RTF, to PDF, etc. Also, it can be
translated by i18n team. KDE scripts run around to extract strings and
created pot files for translators. Another scripts get .po files
translated and re-inject at the right place the translation strings...

http://www.docbook.org/

The handbook repository is here in GIT :

https://projects.kde.org/projects/extragear/graphics/digikam/digikam-doc
https://projects.kde.org/projects/extragear/graphics/kipi-plugins/kipi-plugins-doc

The main goal of an handbook writer is to write right missing sections
in handbook. Current handbook must be printed or displayed in first to
see missing parts.

Others jobs is to review current documentation and to patch text.

As handbook is text file, you can patch sections and use git diff
command like this :

git diff > new.patch

Later, i can review your patch and include it in git repository.

But it's better to have a git account to contribute here, especially
is more than one contributor want to help on handbook writing.

// -----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Note, that we have a super repository which include all 2.0 source
code, all main dependencies written by digiKam team, and handbook :

https://projects.kde.org/projects/extragear/graphics/digikam/digikam-software-compilation

Checkout the repository and run :

./download-repos
./cmake .
./make

Of course, all dependencies must be resolved before. Look _ALL_ NEWS
files for details

// -----------------------------------------------------------------------------------------------------------------------------------------------------------------------

I hope that it's clarify a little bit the digiKam handbook writing way.

Best

Gilles Caulier

2011/3/6 Harry Henry Gebel <[hidden email]>:

> Is that also who I contact if I want to contribute updates to the manual?
>
> On Sat, Mar 5, 2011 at 2:02 AM, Gilles Caulier <[hidden email]> wrote:
>> If PDF file is not restored in the future, please contact KDE i18n
>> team which manage scripts to generate PDF from docbook files...
>>
>> Gilles Caulier
>>
>> 2011/3/5 Harry Henry Gebel <[hidden email]>:
>>> Thanks for you fast and helpful reply!
>>>
>>> -Harry
>>>
>>>>
>>>> It due to recent subversion to Git migration. It will be solved soon
>>>> by KDE team.
>>>>
>>>>
>>>> Documentation repository is there :
>>>>
>>>> https://projects.kde.org/projects/extragear/graphics/digikam/digikam-doc/repository
>>>>
>>>> Gilles Caulier
>>> _______________________________________________
>>> Digikam-users mailing list
>>> [hidden email]
>>> https://mail.kde.org/mailman/listinfo/digikam-users
>>>
>> _______________________________________________
>> Digikam-users mailing list
>> [hidden email]
>> https://mail.kde.org/mailman/listinfo/digikam-users
>>
> _______________________________________________
> Digikam-users mailing list
> [hidden email]
> https://mail.kde.org/mailman/listinfo/digikam-users
>

_______________________________________________
Digikam-users mailing list
[hidden email]
https://mail.kde.org/mailman/listinfo/digikam-users