Re: [GNC-dev] GnuCash - documentation display disfunctional and sources

[Frank H. Ellenberger]

Am 11.04.2018 um 16:09 schrieb Stefan Mueller:
> In addition, I've noticed that the translated help is not pulled up when
> changing the language on gnucash.org
> , although it is available:
> 
> GnuCash Documentation EN
>  àgnucash help EN
> 
> GnuCash Documentation DE
>  àgnucash help EN
>  although there is gnucash
> help DE 
> GnuCash Documentation IT
>  àgnucash help EN
>  although there is gnucash
> help IT 
> 
> That is properly due to that the folder in .../docs
>  are not named according the format of Locale
> .
> 

Only partial: Old versions were of the form ll_rr. whith ll: language
code, rr: region code. That had the downside, de_AT , de_CH, ... would
result in C instead of de. So as long as no 2. translation is provided
as for zh, we prefer to use ll only. But then comes the compatibility ...

At least it should be fixed for now.

> thx
> 
> stefan

~Frank
___
gnucash-devel mailing list
gnucash-devel@gnucash.org
https://lists.gnucash.org/mailman/listinfo/gnucash-devel

Re: [GNC-dev] GnuCash - documentation display disfunctional and sources

[Stefan Mueller]

thanks for the information. I might find the time to adapt the removed page
as it was very helpful to me and should return to the documentation, but
updated to new interface.

2018-04-11 19:06 GMT+02:00 Geert Janssens :

> Op woensdag 11 april 2018 16:09:57 CEST schreef Stefan Mueller:
> > Hallo,
> > I the course of my researches in regard to *Import Map Editor* I've
> noticed
> > that there are two branches of documentation, *stable
> > * and *git <
> https://cvs.gnucash.org/docs>*
> > and that there are some lonely help docs. on *git*: 2.7. Daten
> importieren
> >  what
> > shall go into the official documentation.
>
> What you are looking at are the html translation of our documentation. It's
> not the version managed documentation source though.
>
> That is written in docbook format and stored here:
> https://github.com/Gnucash/gnucash-docs/
>
> The specific page is a relic of documentation that got removed from the
> documentation sources in 2015 by Mechtilde in this commit:
> https://github.com/Gnucash/gnucash-docs/commit/31d724b34ceaa98d7aa29
>
> The html page should not have been there anymore and is a heads up we
> should
> update our nightly documentation build to clean out obsolete files.
>
> However in this case it's nice you found it and it triggers you to
> re-enable
> it.
> >
> > In order to do so I would have to clone the documentation repository and
> > reorder the html files and reset the links and commit it.
>
> Not exactly. You'd have to translate the html pages back into docbook
> format
> and update them to reflect current stable. The importer (particularly the
> csv
> one) has changed since that documentation was written.
>
> It's probably easier though to search for the original docbook source in
> git
> history and start from there.
>
> I have quickly searched the current documentation sources and it appears
> there
> is no information on importing either in the English documentation. That's
> likely why it got removed from DE at some point as the English version is
> considered the primary documentation and the other languages are 'only'
> translations. (Though that may not necessarily be the right approach)
>
> > Once I have finalized all that, I will notify the developer team of your
> > changes, either by creating a pull request
> >  (pulls my clone into
> > master), or by creating and uploading a patch
> > .
>
> Indeed.
>
> > That's it isn't it?
> > One step is still unclear, how or by whom are the files moved from *git*
> >  to *stable*
> > .
> >
> Never. Both urls you specify are html renderings of the documentation
> sources,
> though they render different branches. These renderings are automatically
> generated from the true git sources (see link above).
>
> The source git repo has two relevant branches: maint and master.
> Whatever is committed to maint will appear in the rendering at https://
> www.gnucash.org/docs/v3/ at the first new release after it got committed.
> Whatever is committed to master will appear in the rendering at https://
> cvs.gnucash.org/docs (though we normally use it's other alias https://
> code.gnucash.org/docs)
>
> In addition *all* commits that go into the maint branch will at some point
> get
> merged into master, and will hence appear in the rendering of that branch
> as
> well. We don't merge the other way around so master can contain
> documentation
> for features that are not yet in a stable gnucash release (though currently
> that's uncommon).
>
> > In addition, I've noticed that the translated help is not pulled up when
> > changing the language on gnucash.org
> > , although it is
> available:
> >
> > GnuCash Documentation EN
> >  àgnucash
> help EN
> > 
> > GnuCash Documentation DE
> >  àgnucash
> help EN
> >  although there is
> gnucash
> > help DE 
> > GnuCash Documentation IT
> >  àgnucash
> help EN
> >  although there is
> gnucash
> > help IT 
> >
> > That is properly due to that the folder in .../docs
> >  are not named according the format of
> Locale
> > .
> >
>
> Right. That should be aligned. I seem to remember we chose to remove the
> region code from the documentation directories at some 

Re: [GNC-dev] GnuCash - documentation display disfunctional and sources

[Geert Janssens]

Op woensdag 11 april 2018 16:09:57 CEST schreef Stefan Mueller:
> Hallo,
> I the course of my researches in regard to *Import Map Editor* I've noticed
> that there are two branches of documentation, *stable
> * and *git *
> and that there are some lonely help docs. on *git*: 2.7. Daten importieren
>  what
> shall go into the official documentation.

What you are looking at are the html translation of our documentation. It's 
not the version managed documentation source though.

That is written in docbook format and stored here:
https://github.com/Gnucash/gnucash-docs/

The specific page is a relic of documentation that got removed from the 
documentation sources in 2015 by Mechtilde in this commit:
https://github.com/Gnucash/gnucash-docs/commit/31d724b34ceaa98d7aa29

The html page should not have been there anymore and is a heads up we should 
update our nightly documentation build to clean out obsolete files.

However in this case it's nice you found it and it triggers you to re-enable 
it.
> 
> In order to do so I would have to clone the documentation repository and
> reorder the html files and reset the links and commit it.

Not exactly. You'd have to translate the html pages back into docbook format 
and update them to reflect current stable. The importer (particularly the csv 
one) has changed since that documentation was written.

It's probably easier though to search for the original docbook source in git 
history and start from there.

I have quickly searched the current documentation sources and it appears there 
is no information on importing either in the English documentation. That's 
likely why it got removed from DE at some point as the English version is 
considered the primary documentation and the other languages are 'only' 
translations. (Though that may not necessarily be the right approach)

> Once I have finalized all that, I will notify the developer team of your
> changes, either by creating a pull request
>  (pulls my clone into
> master), or by creating and uploading a patch
> .

Indeed.

> That's it isn't it?
> One step is still unclear, how or by whom are the files moved from *git*
>  to *stable*
> .
> 
Never. Both urls you specify are html renderings of the documentation sources, 
though they render different branches. These renderings are automatically 
generated from the true git sources (see link above).

The source git repo has two relevant branches: maint and master.
Whatever is committed to maint will appear in the rendering at https://
www.gnucash.org/docs/v3/ at the first new release after it got committed.
Whatever is committed to master will appear in the rendering at https://
cvs.gnucash.org/docs (though we normally use it's other alias https://
code.gnucash.org/docs)

In addition *all* commits that go into the maint branch will at some point get 
merged into master, and will hence appear in the rendering of that branch as 
well. We don't merge the other way around so master can contain documentation 
for features that are not yet in a stable gnucash release (though currently 
that's uncommon).

> In addition, I've noticed that the translated help is not pulled up when
> changing the language on gnucash.org
> , although it is available:
> 
> GnuCash Documentation EN
>  àgnucash help EN
> 
> GnuCash Documentation DE
>  àgnucash help EN
>  although there is gnucash
> help DE 
> GnuCash Documentation IT
>  àgnucash help EN
>  although there is gnucash
> help IT 
> 
> That is properly due to that the folder in .../docs
>  are not named according the format of Locale
> .
> 

Right. That should be aligned. I seem to remember we chose to remove the 
region code from the documentation directories at some point. We probably 
should do the same for the website's html, or alternatively make the 
documentation selection in viewdoc.phtml more intelligent and try with and 
without region code if there is one in the chosen language.

Regards,

Geert


___
gnucash-devel mailing list
gnucash-devel@gnucash.org
https://lists.gnucash.org/mailman/listinfo/gnucash-devel