The International Simutrans Forum

Community => Simutrans Help Center => Tutorials => Topic started by: prissi on January 01, 2010, 08:11:45 PM

Title: Help files now accessible directly via HTML
Post by: prissi on January 01, 2010, 08:11:45 PM
Thanks to Franks efforts the help files are now directly accessible via a browser.

Use http://simutrans-germany.com/translator/data/html/index.html (http://simutrans-germany.com/translator/data/html/index.html) to go to your language.

This might be also useful for people who want to print out the help files ...
Title: Re: Help files now accessible directly via HTML
Post by: VS on January 01, 2010, 10:02:28 PM
Absolutely great! This will help a lot.
Title: Re: Help files now accessible directly via HTML
Post by: Isaac.Eiland-Hall on January 01, 2010, 10:51:49 PM
Ooh, this is nice!
Title: Re: Help files now accessible directly via HTML
Post by: z9999+ on January 02, 2010, 08:32:26 AM
In html, element of italic is , it is not <it>.
Title: Re: Help files now accessible directly via HTML
Post by: skreyola on January 03, 2010, 04:13:35 AM
actually, {em} (emphasis) is the preferred element. Semantic and all.
Title: Re: Help files now accessible directly via HTML
Post by: z9999+ on January 03, 2010, 05:56:10 AM
actually, {em} (emphasis) is the preferred element. Semantic and all.

Sorry, I'm not talking about such a thing.

We should use < i > element for help text, and also in your site, it should be applied the same style as in-game help text for < i > element.
We should not use <it> element which is invalid in html.

Your html parser is wrong.
This translation rule (http://simutrans-germany.com/wiki/wiki/tiki-index.php?page=en_Texts) is also wrong.
Title: Re: Help files now accessible directly via HTML
Post by: VS on January 03, 2010, 10:07:22 AM
Since a direct translation produces invalid html (although still working!), delving on tag semantics is a bit premature ;) Talking about semantics, for Simutrans help texts the presentation is the semantic meaning.

Anyway, this tool helps a lot for translating and reviewing the help system as a whole, so it's a huge help even if not html 4.01 strict...
Title: Re: Help files now accessible directly via HTML
Post by: Frank on January 03, 2010, 10:45:06 AM
the problem is no official documentation from tags

use in help files it and strong

correct for simutrans program is i and st

japanese files use i, other files use it
Title: Re: Help files now accessible directly via HTML
Post by: Dwachs on January 03, 2010, 12:03:30 PM
Here is a kind of semi-official documentation of tags in help files:

br, p .. line break
a .. hyper-link, text color blue
em .. text color white
st .. text color red
h1 .. text is drawn twice with background text in white
i ..  text is drawn twice with background text in yellow
title .. window title

The text color inside i and h1 tags can be changed with the em/st tags.

There are no italic fonts available, so h1 and i uses shadowed texts.

The tags only have to begin with the letters as above, so
Code: [Select]
<i>
<it>
<italic>
<idiotic>
<idksdkhdksjg>
are all equivalent.

Opening and closing tag needs not to be identical, so closing < i> with </identitycrisis> is legal.

The wiki page is not wrong, it uses html tags, which fits completely the scheme above.
Title: Re: Help files now accessible directly via HTML
Post by: Dwachs on January 03, 2010, 12:44:46 PM
Should simutrans and the translator force to use valid html istead of a zoo of different tags?
Title: Re: Help files now accessible directly via HTML
Post by: VS on January 03, 2010, 02:55:03 PM
Myself, I would prefer a robust solution to crippled + politically correct... which also means keeping the status quo - how convenient! ;)
Title: Re: Help files now accessible directly via HTML
Post by: Spike on January 03, 2010, 04:29:37 PM
Here is a kind of semi-official documentation of tags in help files:

br, p .. line break
a .. hyper-link, text color blue
em .. text color white
st .. text color red
h1 .. text is drawn twice with background text in white
i ..  text is drawn twice with background text in yellow
title .. window title

The text color inside i and h1 tags can be changed with the em/st tags.

There are no italic fonts available, so h1 and i uses shadowed texts.

The tags only have to begin with the letters as above, so
Code: [Select]
<i>
<it>
<italic>
<idiotic>
<idksdkhdksjg>
are all equivalent.

Eh. Even that my code only checked the first letters, my files had <strong> written in them, not just <st>. And it was not intended that people cheat on the spelling :/

I had not used the tags for italic or bold intentionally, but only < em> and < strong> so that the target system can decide how to emphasize some text, or make it appear stronger.

Files should:

- have correct tags
- not depend on actual formatting (colors, italics) but semantics

Title: Re: Help files now accessible directly via HTML
Post by: z9999+ on January 04, 2010, 07:17:40 AM
japanese files use i, other files use it
I will repeat, <it> is not valid html element.
We should not use it.

Quote
Release of 99.02.2

21-Oct-2006: (prissi)

   ADD: < i > attribute for the help texts

Who changed it to <it> ? You ?


Unfortunately, japanse font weight is light, so white and red texts is not readable in simutrans help, even if it is semantics.
Only the readable text with highlighted is italic which is highlighted by yellow.
There is no alternative for us.
Title: Re: Help files now accessible directly via HTML
Post by: Dwachs on January 04, 2010, 09:40:41 AM
Imho, we could easily make the parsing stricter, ie only html-Tags are allowed. Then maybe a script is needed to make all existing texts conforming to this requirements.
Title: Re: Help files now accessible directly via HTML
Post by: skreyola on February 14, 2010, 02:35:32 AM
I'm okay with its being unique.
I just figure if it's valid xhtml, it can be parsed later by a variety of programs without rehashing the code.
But I'm OK with its being something else.