Re: [Tails-l10n] Dropping CSS formating for GUI documentatio…

Delete this message

Reply to this message
Author: sajolida
Date:  
To: Tails localization discussion
Subject: Re: [Tails-l10n] Dropping CSS formating for GUI documentation
u:
> Hi!


Hey!

> sajolida:
>>> Maybe i'm wrong, but isn't it also possible to use custom html
>>> attributes nowadays? Something like
>>> <application>Tails Installer</application>
>>> would (imo) also be an improvement and would not have the downside of
>>> losing the 'styleability'.
>>
>> HTML 5 allows you to define custom data-* attributes:
>>
>> https://developer.mozilla.org/en-US/docs/Learn/HTML/Howto/Use_data_attributes
>>
>> An attribute being a property of a tag. But I don't think HTML 5 allows
>> you to create custom *tags*.
>
> Actually it is possible to define custom tags:
> https://developers.google.com/web/fundamentals/web-components/customelements


Thanks for educating me!

> It's now part of the standard, but it has to be done with JS and I don't
> think this is something we want to rely on, as we do not build an app,
> but simply a website.


Indeed.

>>>> For example:
>>>>
>>>> - <span class="application">Tails Installer</span>
>>>>
>>>> Would become:
>>>>
>>>> - *Tails Installer*
>
> When we wrote the partners page in HTML, we paid great attention to
> separate all the strings, so that not much HTML appeared in the PO files.
>
> The PO plugin basically reads things in <p> tags at once it seems. So if
> you would rename your <span class="whatever"> into <p class="whatever">,
> the HTML would not appear in the PO file.
>
> I know this is not always possible, but it's something that could be
> improved on some pages.


Right. Note that the parsing and splitting of HTML into different PO
strings is only done on pages with the .html extension. On pages with
the .mdwn extension, HTML is not parsed at all by the PO plugin.

This is the most common case and what I'm discussing here: the way we
embed HTML into Markdown for formatting special bits of the text using
CSS classes.

On the other hand, on pages with the .html extension, everything has to
be written in HTML which makes it much more complicated to write and
maintain for us writters.

--
sajolida