[digiKam-users] Tutorials section on digikam.org?

[AndriusWild]

Hello,

I understand that the user manual is not really intended to be tutorials but rather a module reference. So I was wondering if it would be possible to create a Tutorials section on the website. Something that is more contrib-friendly than the Git + XML would be amazing to have.

Everyone is welcome to share their thoughts here.

Thanks,

Andrey

[Gilles Caulier-4]

Le lun. 27 janv. 2020 à 15:16, Andrey Goreev <[hidden email]> a écrit :

Hello,

I understand that the user manual is not really intended to be tutorials but rather a module reference. So I was wondering if it would be possible to create a Tutorials section on the website.

All is possible, but the human power is not infinite (:=)))...

Including tutorial section using wiki like accessible from a web interface will take age and will require a security policy on DK web page.

Krita project as this kind of tutorial section, but it not a simple task to do :

https://docs.krita.org/en/tutorials.html#tutorials

Look on bottom of the page, this is not the docbook XML based documentation.

I suppose that KDE admin team has a way to deploy this kind of stuff, as all is managed by KDE project about web publication/access.

So the best way is to contact the Krita team to know the details and to know how to start to create a DK tutorials section...

Best

Gilles Caulier

[AndriusWild]

Looks like they are using Sphinx

https://docs.krita.org/en/contributors_manual/krita_manual_readme.html

“Sphinx works by writing simple text files with reStructuredText mark up, and then it takes those text files and turns them into the manual. We keep track of changes in the manual by putting them into a version control system called Git.”

 

From: Digikam-users <[hidden email]> On Behalf Of Gilles Caulier
Sent: Tuesday, January 28, 2020 8:28 AM
To: digiKam - Home Manage your photographs as a professional with the power of open source <[hidden email]>
Subject: Re: [digiKam-users] Tutorials section on digikam.org?

 

 

 

Le lun. 27 janv. 2020 à 15:16, Andrey Goreev <[hidden email]> a écrit :

Hello,

I understand that the user manual is not really intended to be tutorials but rather a module reference. So I was wondering if it would be possible to create a Tutorials section on the website.

 

All is possible, but the human power is not infinite (:=)))...

 

Including tutorial section using wiki like accessible from a web interface will take age and will require a security policy on DK web page.

 

Krita project as this kind of tutorial section, but it not a simple task to do :

 

https://docs.krita.org/en/tutorials.html#tutorials

 

Look on bottom of the page, this is not the docbook XML based documentation.

 

I suppose that KDE admin team has a way to deploy this kind of stuff, as all is managed by KDE project about web publication/access.

 

So the best way is to contact the Krita team to know the details and to know how to start to create a DK tutorials section...

 

Best

 

Gilles Caulier

[AndriusWild]

It could also be done with posting links to screencasts (mp4 files) like this guy did: (see “Video demos” section)

https://bitbucket.org/agriggio/art/wiki/Home

 

From: Andrey Goreev <[hidden email]>
Sent: Tuesday, January 28, 2020 8:57 AM
To: 'digiKam - Home Manage your photographs as a professional with the power of open source' <[hidden email]>
Subject: RE: [digiKam-users] Tutorials section on digikam.org?

 

Looks like they are using Sphinx

https://docs.krita.org/en/contributors_manual/krita_manual_readme.html

“Sphinx works by writing simple text files with reStructuredText mark up, and then it takes those text files and turns them into the manual. We keep track of changes in the manual by putting them into a version control system called Git.”

 

From: Digikam-users <[hidden email]> On Behalf Of Gilles Caulier
Sent: Tuesday, January 28, 2020 8:28 AM
To: digiKam - Home Manage your photographs as a professional with the power of open source <[hidden email]>
Subject: Re: [digiKam-users] Tutorials section on digikam.org?

 

 

 

Le lun. 27 janv. 2020 à 15:16, Andrey Goreev <[hidden email]> a écrit :

Hello,

I understand that the user manual is not really intended to be tutorials but rather a module reference. So I was wondering if it would be possible to create a Tutorials section on the website.

 

All is possible, but the human power is not infinite (:=)))...

 

Including tutorial section using wiki like accessible from a web interface will take age and will require a security policy on DK web page.

 

Krita project as this kind of tutorial section, but it not a simple task to do :

 

https://docs.krita.org/en/tutorials.html#tutorials

 

Look on bottom of the page, this is not the docbook XML based documentation.

 

I suppose that KDE admin team has a way to deploy this kind of stuff, as all is managed by KDE project about web publication/access.

 

So the best way is to contact the Krita team to know the details and to know how to start to create a DK tutorials section...

 

Best

 

Gilles Caulier

[Gilles Caulier-4]

Why not to use https://pixls.us/articles/ as well ?

Gilles Caulier

Le mar. 28 janv. 2020 à 12:18, Andrey Goreev <[hidden email]> a écrit :

It could also be done with posting links to screencasts (mp4 files) like this guy did: (see “Video demos” section)

https://bitbucket.org/agriggio/art/wiki/Home

 

From: Andrey Goreev <[hidden email]>
Sent: Tuesday, January 28, 2020 8:57 AM
To: 'digiKam - Home Manage your photographs as a professional with the power of open source' <[hidden email]>
Subject: RE: [digiKam-users] Tutorials section on digikam.org?

 

Looks like they are using Sphinx

https://docs.krita.org/en/contributors_manual/krita_manual_readme.html

“Sphinx works by writing simple text files with reStructuredText mark up, and then it takes those text files and turns them into the manual. We keep track of changes in the manual by putting them into a version control system called Git.”

 

From: Digikam-users <[hidden email]> On Behalf Of Gilles Caulier
Sent: Tuesday, January 28, 2020 8:28 AM
To: digiKam - Home Manage your photographs as a professional with the power of open source <[hidden email]>
Subject: Re: [digiKam-users] Tutorials section on digikam.org?

 

 

 

Le lun. 27 janv. 2020 à 15:16, Andrey Goreev <[hidden email]> a écrit :

Hello,

I understand that the user manual is not really intended to be tutorials but rather a module reference. So I was wondering if it would be possible to create a Tutorials section on the website.

 

All is possible, but the human power is not infinite (:=)))...

 

Including tutorial section using wiki like accessible from a web interface will take age and will require a security policy on DK web page.

 

Krita project as this kind of tutorial section, but it not a simple task to do :

 

https://docs.krita.org/en/tutorials.html#tutorials

 

Look on bottom of the page, this is not the docbook XML based documentation.

 

I suppose that KDE admin team has a way to deploy this kind of stuff, as all is managed by KDE project about web publication/access.

 

So the best way is to contact the Krita team to know the details and to know how to start to create a DK tutorials section...

 

Best

 

Gilles Caulier