The International Simutrans Forum

 

Author Topic: Help files now accessible directly via HTML  (Read 8517 times)

0 Members and 1 Guest are viewing this topic.

Offline prissi

  • Developer
  • Administrator
  • *
  • Posts: 9595
  • Languages: De,EN,JP
Help files now accessible directly via HTML
« 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 to go to your language.

This might be also useful for people who want to print out the help files ...
« Last Edit: February 21, 2010, 06:16:46 PM by IgorTekton »

Offline VS

  • Senior Plumber (Devotee)
  • Devotee
  • *
  • Posts: 4855
  • Vladimír Slávik
    • VS's Simutrans site
  • Languages: CS,EN
Re: Help files now accessible directly via HTML
« Reply #1 on: January 01, 2010, 10:02:28 PM »
Absolutely great! This will help a lot.

Offline Isaac.Eiland-Hall us

  • Benevolent Dictator
  • Administrator
  • *
  • Posts: 3664
  • PanamaCityPC.com/support/
    • Facebook Profile
  • Languages: EN
Re: Help files now accessible directly via HTML
« Reply #2 on: January 01, 2010, 10:51:49 PM »
Ooh, this is nice!

Offline z9999+

  • Coder/patcher
  • *
  • Posts: 377
Re: Help files now accessible directly via HTML
« Reply #3 on: January 02, 2010, 08:32:26 AM »
In html, element of italic is , it is not <it>.

Offline skreyola

  • *
  • Posts: 337
  • Trivial Troubleshooter
Re: Help files now accessible directly via HTML
« Reply #4 on: January 03, 2010, 04:13:35 AM »
actually, {em} (emphasis) is the preferred element. Semantic and all.

Offline z9999+

  • Coder/patcher
  • *
  • Posts: 377
Re: Help files now accessible directly via HTML
« Reply #5 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 is also wrong.

Offline VS

  • Senior Plumber (Devotee)
  • Devotee
  • *
  • Posts: 4855
  • Vladimír Slávik
    • VS's Simutrans site
  • Languages: CS,EN
Re: Help files now accessible directly via HTML
« Reply #6 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...

Offline Frank

  • Inactive/Retired
  • *
  • Posts: 1431
  • Languages: DE
Re: Help files now accessible directly via HTML
« Reply #7 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

Offline Dwachs

  • DevTeam, Coder/patcher
  • Administrator
  • *
  • Posts: 4608
  • Languages: EN, DE, AT
Re: Help files now accessible directly via HTML
« Reply #8 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.

Offline Dwachs

  • DevTeam, Coder/patcher
  • Administrator
  • *
  • Posts: 4608
  • Languages: EN, DE, AT
Re: Help files now accessible directly via HTML
« Reply #9 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?

Offline VS

  • Senior Plumber (Devotee)
  • Devotee
  • *
  • Posts: 4855
  • Vladimír Slávik
    • VS's Simutrans site
  • Languages: CS,EN
Re: Help files now accessible directly via HTML
« Reply #10 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! ;)

Offline Spike

  • *
  • Posts: 1361
  • First Simutrans Developer and Graphics Artist
Re: Help files now accessible directly via HTML
« Reply #11 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


Offline z9999+

  • Coder/patcher
  • *
  • Posts: 377
Re: Help files now accessible directly via HTML
« Reply #12 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.
« Last Edit: January 04, 2010, 07:56:48 AM by z9999+ »

Offline Dwachs

  • DevTeam, Coder/patcher
  • Administrator
  • *
  • Posts: 4608
  • Languages: EN, DE, AT
Re: Help files now accessible directly via HTML
« Reply #13 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.

Offline skreyola

  • *
  • Posts: 337
  • Trivial Troubleshooter
Re: Help files now accessible directly via HTML
« Reply #14 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.