News:

SimuTranslator
Make Simutrans speak your language.

Help files now accessible directly via HTML

Started by prissi, January 01, 2010, 08:11:45 PM

Previous topic - Next topic

0 Members and 1 Guest are viewing this topic.

prissi

Thanks to Franks efforts the help files are now directly accessible via a browser.

Use 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 ...

VS


My projects... Tools for messing with Simutrans graphics. Graphic archive - templates and some other stuff for painters. Development logs for most recent information on what is going on. And of course pak128!

Isaac Eiland-Hall


z9999+

In html, element of italic is , it is not <it>.

skreyola

actually, {em} (emphasis) is the preferred element. Semantic and all.
--Skreyola
You can also help translate for your language with SimuTranslator.

z9999+

Quote from: skreyola on January 03, 2010, 04:13:35 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 is also wrong.

VS

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...

My projects... Tools for messing with Simutrans graphics. Graphic archive - templates and some other stuff for painters. Development logs for most recent information on what is going on. And of course pak128!

Frank

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

Dwachs

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

<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.
Parsley, sage, rosemary, and maggikraut.

Dwachs

Should simutrans and the translator force to use valid html istead of a zoo of different tags?
Parsley, sage, rosemary, and maggikraut.

VS

Myself, I would prefer a robust solution to crippled + politically correct... which also means keeping the status quo - how convenient! ;)

My projects... Tools for messing with Simutrans graphics. Graphic archive - templates and some other stuff for painters. Development logs for most recent information on what is going on. And of course pak128!

Spike

Quote from: 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

<i>
<it>
<italic>
<idiotic>
<idksdkhdksjg>

are all equivalent.

Eh. Even that my code only checked the first letters, my files had 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

>

z9999+

#12
Quote from: Frank on January 03, 2010, 10:45:06 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.

Dwachs

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.
Parsley, sage, rosemary, and maggikraut.

skreyola

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.
--Skreyola
You can also help translate for your language with SimuTranslator.