Re: HTML build: Howto append language to internal link URLs

[Shaun McCance]

On Tue, 2018-02-20 at 16:58 +0100, Gunnar Hjalmarsson wrote:
> On 2018-02-20 16:10, Shaun McCance wrote:
> > > Are this kind of available parameters documented anywhere?
> > 
> > Right here:
> > 
> > http://yelp.io/xsl/parameters.html
> > 
> > Every parameter has docs. Whether the docs for any given parameter
> > are
> > actually any good is another question. Please complain about
> > anything
> > you don't understand so I can make the docs better.
> 
> Thanks Shaun, much appreciated!
> 
> Well, not exactly a complaint, but... Currently we are reconsidering
> a 
> few details with respect to the HTML version of Ubuntu's desktop
> guide, 
> which is Mallard just as GNOME Help. Probably we want to do
> something 
> similar with Ubuntu's server guide later whose markup language is 
> DocBook. Is there some DocBook equivalent to mal.link.extension? I
> don't 
> see it when looking at .


http://yelp.io/xsl/db.chunk.extension.html

The parameters around this stuff kind of grew organically, from before
Mallard was even around, and from before there was a unified HTML
output for multiple formats. So it's a bit fragmented. In a happier
world, we'd just have html.link.extension instead of format-specific
parameters. Sorry.

(Also, the docs on that DocBook parameter are awful, and probably
predate html.extension even existing. Sorry again.)

By the way, in case people are interested in using Pintail to build
their docs sites, it handles all these link parameters for you.





___
gnome-doc-list mailing list
gnome-doc-list@gnome.org
https://mail.gnome.org/mailman/listinfo/gnome-doc-list

Re: HTML build: Howto append language to internal link URLs

[Gunnar Hjalmarsson]

On 2018-02-20 16:58, Gunnar Hjalmarsson wrote:

Indeed we put files with .html. on the server, but for
historical reasons that step is accomplished with sed(). ;)


Apparently not sed(), rather cp and/or mv. Sorry, I'm a bit 
absent-minded today.


--
Gunnar Hjalmarsson
https://launchpad.net/~gunnarhj
___
gnome-doc-list mailing list
gnome-doc-list@gnome.org
https://mail.gnome.org/mailman/listinfo/gnome-doc-list

Re: HTML build: Howto append language to internal link URLs

[Gunnar Hjalmarsson]

On 2018-02-20 16:10, Shaun McCance wrote:

On Sat, 2018-02-17 at 16:15 +0100, Gunnar Hjalmarsson wrote:

Unless I'm misunderstanding the question, you should almost certainly
be setting html.extension as well or instead. html.extension is the
extension used when actually outputting files. mal.link.extension is
the extension used when writing links.


Indeed we put files with .html. on the server, but for historical 
reasons that step is accomplished with sed(). ;) It was really the 
extension in the link URLs I asked about.



Are this kind of available parameters documented anywhere?


Right here:

http://yelp.io/xsl/parameters.html

Every parameter has docs. Whether the docs for any given parameter are
actually any good is another question. Please complain about anything
you don't understand so I can make the docs better.


Thanks Shaun, much appreciated!

Well, not exactly a complaint, but... Currently we are reconsidering a 
few details with respect to the HTML version of Ubuntu's desktop guide, 
which is Mallard just as GNOME Help. Probably we want to do something 
similar with Ubuntu's server guide later whose markup language is 
DocBook. Is there some DocBook equivalent to mal.link.extension? I don't 
see it when looking at .


--
Gunnar Hjalmarsson
https://launchpad.net/~gunnarhj
___
gnome-doc-list mailing list
gnome-doc-list@gnome.org
https://mail.gnome.org/mailman/listinfo/gnome-doc-list

Re: HTML build: Howto append language to internal link URLs

[Shaun McCance]

On Sat, 2018-02-17 at 16:15 +0100, Gunnar Hjalmarsson wrote:
> On 2018-02-16 09:58, Frederic Peters wrote:
> > library-web adjust some parameters; this change comes from:
> > 
> > > select="concat('.html.',$libgo.lang)"/>
> > 
> > ($libgo.lang contains the language being generated)
> > 
> > This is from https://git.gnome.org/browse/library-web/tree/data/xsl
> > t/mal2html.xsl
> > 
> > Hope it helps,

Unless I'm misunderstanding the question, you should almost certainly
be setting html.extension as well or instead. html.extension is the
extension used when actually outputting files. mal.link.extension is
the extension used when writing links.

> Indeed it does. Thanks! And thanks to Petr who forwarded this to the 
> right person.
> 
> Which leads me to a follow-up question: Are this kind of available 
> parameters documented anywhere?

Right here:

http://yelp.io/xsl/parameters.html

Every parameter has docs. Whether the docs for any given parameter are
actually any good is another question. Please complain about anything
you don't understand so I can make the docs better.

Thanks,
Shaun

___
gnome-doc-list mailing list
gnome-doc-list@gnome.org
https://mail.gnome.org/mailman/listinfo/gnome-doc-list

Re: HTML build: Howto append language to internal link URLs

[Gunnar Hjalmarsson]

On 2018-02-16 09:58, Frederic Peters wrote:

library-web adjust some parameters; this change comes from:

   

($libgo.lang contains the language being generated)

This is from 
https://git.gnome.org/browse/library-web/tree/data/xslt/mal2html.xsl

Hope it helps,


Indeed it does. Thanks! And thanks to Petr who forwarded this to the 
right person.


Which leads me to a follow-up question: Are this kind of available 
parameters documented anywhere?


--
Gunnar Hjalmarsson
https://launchpad.net/~gunnarhj
___
gnome-doc-list mailing list
gnome-doc-list@gnome.org
https://mail.gnome.org/mailman/listinfo/gnome-doc-list

Re: HTML build: Howto append language to internal link URLs

[Frederic Peters]

Petr Kovar wrote:
> Adding Fred who maintains the help.gnome.org site, he might know more.

Thanks Petr.

> On Tue, 13 Feb 2018 21:12:15 +0100
> Gunnar Hjalmarsson  wrote:
> 
> > A HTML build of the Mallard pages are published at 
> > , similar to 
> > . However, there is one 
> > important detail which differs: The URLs of the internal links on the 
> > GNOME site include a language suffix. For instance, while the link at 
> > the index page to "Your desktop" looks like this on GNOME:
> > 
> > Your desktop
> > 
> > it looks like this on Ubuntu:
> > 
> > Your desktop
> > 
> > i.e. we don't have the ".en" (or ".fr" or ".de" etc.) suffix.
> > 
> > So I have a simple question: How do you do that?

library-web adjust some parameters; this change comes from:

  

($libgo.lang contains the language being generated)

This is from 
https://git.gnome.org/browse/library-web/tree/data/xslt/mal2html.xsl


Hope it helps,

Fred
___
gnome-doc-list mailing list
gnome-doc-list@gnome.org
https://mail.gnome.org/mailman/listinfo/gnome-doc-list

Re: HTML build: Howto append language to internal link URLs

[Petr Kovar]

Adding Fred who maintains the help.gnome.org site, he might know more.


On Tue, 13 Feb 2018 21:12:15 +0100
Gunnar Hjalmarsson  wrote:

> A HTML build of the Mallard pages are published at 
> , similar to 
> . However, there is one 
> important detail which differs: The URLs of the internal links on the 
> GNOME site include a language suffix. For instance, while the link at 
> the index page to "Your desktop" looks like this on GNOME:
> 
> Your desktop
> 
> it looks like this on Ubuntu:
> 
> Your desktop
> 
> i.e. we don't have the ".en" (or ".fr" or ".de" etc.) suffix.
> 
> So I have a simple question: How do you do that?
> 
> The GNOME model appears to make it easier to navigate the site in some 
> other language but the one which is set in the web browser, and I think 
> that changing this in Ubuntu would address 
>  nicely.
> 
> Any pointer/guidance on how to add such language suffixes to the 
> internal link URLs would be much appreciated.
> 
> Thanks!
> 
> -- 
> Gunnar Hjalmarsson
> https://launchpad.net/~gunnarhj
> ___
> gnome-doc-list mailing list
> gnome-doc-list@gnome.org
> https://mail.gnome.org/mailman/listinfo/gnome-doc-list
___
gnome-doc-list mailing list
gnome-doc-list@gnome.org
https://mail.gnome.org/mailman/listinfo/gnome-doc-list