Translation HOWTO

A guide on how to translate Miasmata into other languages

Introduction

If you are interested in translating Miasmata into your language please get in touch!

There's some parts of the translation that you can get started with right away from the instructions on this page, but others need a bit of technical work which I can take care of.

If you get in touch I can also make sure people aren't duplicating effort translating into the same language.

Released & In-progress Translations

French

Translator: Gooby
http://steamcommunity.com/app/223510/discussions/0/540741859566627042/

Italian

https://steamcommunity.com/app/223510/discussions/0/483368433106728776/

Spanish

https://steamcommunity.com/sharedfiles/filedetails/?id=686531105

Russian

https://steamcommunity.com/sharedfiles/filedetails/?id=2642614367

Czech

Translator: Khalashnikovf
Status: Interest registered.

German

Possible Translator: Eternie
Status: Interest in helping out registered.

Part 1: Menus and Tutorials

This is something you can start working on pretty easily without my help.

1. Download Miasmod v1.2 or later from here: http://steamcommunity.com/app/223510/discussions/0/630800445647188169/
   
2. In Miasmod click 'New Mod' and give it an appropriate name (like 'french'). If you come back to edit it later you can double click it in the Environment Mods list.
   
3. Go through the list in Part 1A and find each item in the tree view. Edit the text for each one remembering to periodically save your changes.

Notes

• Whenever you save the mod, Miasmod will ask you if you want to synchonise alocalmod - you should do this so you can see the results in-game.
  
• Don't bother with the glance left/right key bindings - these aren't used in the game and the community patch removes them from the menu.
  
• The supported encoding is Windows-1252 (AKA Code page 1252), which supports latin characters including most accented characters. If you try to use any characters that are not supported by that encoding scheme Miasmod will give you a warning and will remove the unsupported characters. See the wikipedia article for a table of supported characters: https://en.wikipedia.org/wiki/Windows_1252 (note that this restriction does not apply in part 2 - there we are only limited by the characters that the fonts support, and we can always use other fonts if needed).
  
• When you see a word in curly brackets it will be replaced with the key(s) the user currently has bound to that action, so this word should not be translated. e.g. "Take it with {ACTIVATE}"
  
• The font size can be adjusted under menus→fonts→default→height if some of the translated text is too large. Try not to reduce this too much if you can avoid it - for the French translation we only reduced it by 1.
  
• Some of the text in the menus is hardcoded in the executable and can't be translated. This is mostly limited to the settings menus and is things like "low", "medium", "high", "full screen", "windowed", "inverted". Fortunately the descriptions of the settings can be translated and these all have sliders so users can probably guess what they are.

Bonus: In the French translation, Gooby and I added our names to the credits, by inserting new slides before page 8 under endgame→ENDING2 then re-ordering the later pages. This change also needs the corresponding textures made in part 2 below.

Part 1A: List of Menu and Tutorial Text

NOTE: I had to remove some of the English text due to the section character limit, particularly the "Press {HELP}..." messages, so don't rely on this as the canonical source!

Text Location	Original Text
config→new_game→text_description	New Game
config_presets→new_game→text_description	New Game
menus→menus→BIND_KEY→text	Waiting For Key
menus→menus→DELETE_CONFIRM→text	Are you sure you want to delete this save game?
menus→menus→PAUSE_MENU→children→button_quit→text	Quit
menus→menus→PAUSE_MENU→children→button_resume→text	Resume
menus→menus→PAUSE_MENU→children→button_settings→text	Settings
menus→menus→SELECT_GAME→children→tab_quit→text	Quit
menus→menus→SELECT_GAME→children→tab_settings→text	Settings
menus→menus→SETTINGS→children→button_cancel→text	Cancel
menus→menus→SETTINGS→children→button_ok→text	Accept
menus→menus→SETTINGS→children→settings_tab_bindings→children→GI_ACTIVATE→text	Activate
menus→menus→SETTINGS→children→settings_tab_bindings→children→GI_CAM_D→text	Look Down
menus→menus→SETTINGS→children→settings_tab_bindings→children→GI_CAM_L→text	Look Left
menus→menus→SETTINGS→children→settings_tab_bindings→children→GI_CAM_R→text	Look Right
menus→menus→SETTINGS→children→settings_tab_bindings→children→GI_CAM_U→text	Look Up
menus→menus→SETTINGS→children→settings_tab_bindings→children→GI_DOWN→text	Move Back
menus→menus→SETTINGS→children→settings_tab_bindings→children→GI_HELP→text	Help
menus→menus→SETTINGS→children→settings_tab_bindings→children→GI_JUMP→text	Jump
menus→menus→SETTINGS→children→settings_tab_bindings→children→GI_LEFT→text	Step Left
menus→menus→SETTINGS→children→settings_tab_bindings→children→GI_MAP→text	Map
menus→menus→SETTINGS→children→settings_tab_bindings→children→GI_RIGHT→text	Step Right
menus→menus→SETTINGS→children→settings_tab_bindings→children→GI_RUN→text	Run
menus→menus→SETTINGS→children→settings_tab_bindings→children→GI_UP→text	Move Forward
menus→menus→SETTINGS→children→settings_tab_bindings→children→GI_WALK→text	Sneak
menus→menus→SETTINGS→children→settings_tab_bindings→children→GI_ZOOM→text	Examine
menus→menus→SETTINGS→children→settings_tab_bindings→text	Control Keys
menus→menus→SETTINGS→children→settings_tab_general→children→GEN_MOUSE_INVY→text	Invert Y
menus→menus→SETTINGS→children→settings_tab_general→children→GEN_MOUSE_SPD→text	Mouse Speed
menus→menus→SETTINGS→children→settings_tab_general→children→GEN_MUSIC_VOL→text	Music Volume
menus→menus→SETTINGS→children→settings_tab_general→children→GEN_SFX_VOL→text	Master Volume
menus→menus→SETTINGS→children→settings_tab_general→text	General
menus→menus→SETTINGS→children→settings_tab_graphics→children→GFX_ANTIALIASING→text	Antialiasing
menus→menus→SETTINGS→children→settings_tab_graphics→children→GFX_FOV→text	Field of View
menus→menus→SETTINGS→children→settings_tab_graphics→children→GFX_LIGHTSHAFTS→text	Lightshaft Quality
menus→menus→SETTINGS→children→settings_tab_graphics→children→GFX_MDL_DETAIL→text	Model Detail
menus→menus→SETTINGS→children→settings_tab_graphics→children→GFX_RESOLUTION→text	Resolution
menus→menus→SETTINGS→children→settings_tab_graphics→children→GFX_SHADOW_FILT→text	Shadow Filtering
menus→menus→SETTINGS→children→settings_tab_graphics→children→GFX_SKY_QUAL→text	Sky Quality
menus→menus→SETTINGS→children→settings_tab_graphics→children→GFX_TEX_DETAIL→text	Texture Detail
menus→menus→SETTINGS→children→settings_tab_graphics→children→GFX_WATER_QUALITY→text	Water Quality
menus→menus→SETTINGS→children→settings_tab_graphics→children→GFX_WINDOWED→text	Windowed Mode
menus→menus→SETTINGS→children→settings_tab_graphics→text	Graphics
menus→templates→button_cancel→text	Cancel
menus→templates→button_ok→text	Accept
menus→templates→button_savegame→text	Empty
menus→templates→setting_slider→text	default
tutorial→exit1	Press {HELP} to close this topic
tutorial→exit2	Press {MENU} to close and disable this topic
tutorial→pages→approach_urn→text	Flaming Urns provide a zone of protection from aggressors.
tutorial→pages→building2_approach→icon_text	Find freshwater to drink.
tutorial→pages→building2beds_approach→icon_text	Use beds to recuperate strength and also save your game.
tutorial→pages→building2_inside→icon_text	Save your game by lighting candles, lanterns, campfires and urns
tutorial→pages→cartographytable_approach→icon_text	Ahead of you is a Cartography Table.
tutorial→pages→dead_professor→icon_text	This is a Laboratory.
tutorial→pages→first_plant→icon_text	Take plants and fungi by pressing {ACTIVATE}
tutorial→pages→heartbeat→icon_text	The Creature is near!
tutorial→pages→journal_open→icon_text	Press {JOURNAL} to open your Journal
tutorial→pages→labratory_desc→icon_text	There is a note on the table in the shed. Take it with {ACTIVATE}
tutorial→pages→lab_research→icon_text	This is a Research Station.
tutorial→pages→lab_storage→icon_text	This is a Storage Bin.
tutorial→pages→lab_synthesis→icon_text	This is a Synthesis Station.
tutorial→pages→MAP_OPEN→icon_text	Press {MAP} to take out your map
tutorial→pages→pickups_general→icon_text	Grab rocks and fallen sticks.
tutorial→pages→player_drowning→icon_text	You are drowning.
tutorial→pages→player_fatigue→icon_text	You have become fatigued.
tutorial→pages→player_fever→icon_text	You have a fever.
tutorial→pages→player_thirst→icon_text	You are thirsty.
tutorial→pages→player_thirsty→icon_text	You are thirsty.

Part 2: Textures

This is where the bulk of the work lies and where you will probably want my help to generate the new textures and get them into the game.

While working on the French translation with Gooby I wrote some Python scripts to generate the new textures from text files, meaning that if you can send me the translated text I can quickly create the new textures from it.

My scripts expect UTF-8 encoded text files with unix style newlines, so if you can provide me with the translated text in that format it will save me some time. If you aren't sure how to encode a text file like that or it is too tedious to do it for every file don't worry - I can pretty easily convert them from whatever encoding and newline style your text editor defaults to. If you wanted to send me the text in a large pastebin dump instead of individual files that's fine too - just, please don't send them to me as a word document.

To get access to the English textures from the game there are a few options - Naturally you could discover them all yourself in the game, but that would be time consuming and error-prone. If you get in touch I can point you to a website where I have them hosted (I'm not going to post the URL here because it's full of spoilers), or you could extract them from the game yourself - to do this I would recommend using klightspeed's RS5-Extractor as it's much easier to use than my own tools:

http://steamcommunity.com/app/223510/discussions/0/828925216426421301/#c846943082463048999

Start working through the lists below creating the text files mentioned with the translated text. Feel free to periodically send me an in-progress translation rather than waiting until everything is done - that way I can get some of the textures ready and sort out any issues ahead of time.

It's probably a good idea to prioritise coming up with translated names for the plants and drugs early since they get mentioned in a number of places and it can be a pain having to find and edit every reference. Also, send me the blackboard translations early since I do those by hand so they will take longer.

Where noted, you should add Pango markup to change the colour or formatting of particular words. This is only used when we needed to change the format on a specific word within a block of text - the scripts set the appropriate formatting on the entire block. The markup format is documented here:
https://developer.gnome.org/pango/unstable/PangoMarkupFormat.html

Part 2A: Journal Notes Index & Filename Reference

This section lists all of the notes in the journal index. It's also a good reference for looking up which note corresponds with which filename.

The filename of the corresponding notes uses the same number, but with "NOTE" instead of "LIST_Note".

Notes

Text file	English Text	Notes
index\LIST_TITLE_Notes.txt	Notes:
index\LIST_Note0.txt	A Bloody Memo about The Cure
index\LIST_Note1.txt	An Insane Note from Herbert
index\LIST_Note2.txt	Letter from Sanchez about the Anti-Toxin
index\LIST_Note3.txt	Map to Bio-Luminescent Algae
index\LIST_Note4.txt	A Letter from Cornelius about Orchid Extracts	Not used in game
index\LIST_Note5.txt	A Region Map for the Orchadae-Helius.
index\LIST_Note7.txt	A Map to a Tall Plant with a Golden Spadix
index\LIST_Note8.txt	A Regional Map of Outpost Sirius
index\LIST_Note9.txt	A Letter from Isabela about an Adjuvent.
index\LIST_Note10.txt	A procedure for developing The Adjuvent
index\LIST_Note11.txt	A Regional Map for Outpost Rigel
index\LIST_Note12.txt	A Study of Nepenthes Viri Pitcher Plant
index\LIST_Note13.txt	A Study of Plant X
index\LIST_Note14.txt	A Regional Map of Outpost Tau
index\LIST_Note15.txt	A Document on the Synthesis of Anti-Plague Agent
index\LIST_Note16.txt	A Study on the Inonotus Caeruleus Fungus
index\LIST_Note17.txt	A Map to a cache of Pitcher Plants
index\LIST_Note18.txt	A Map to a cache of Pitcher Plants	Not used in game
index\LIST_NoteA1.txt	A Map of Outpost Draco
index\LIST_NoteA2.txt	A Map to Purple Fruit and Jungle Flower
index\LIST_NoteA3.txt	A Map to Giant Bloom and Blue Cap Mushroom
index\LIST_NoteA4.txt	A Map to Sponge and Trumpet Mushrooms
index\LIST_NoteA5.txt	A Guide to Cartography and Triangulation 'B','C'
index\LIST_NOTEA6.txt	A Map of a Swamp Trail
index\LIST_NoteA7.txt	Journal Entry From Herbert #1
index\LIST_NoteA8.txt	Journal Entry From Herbert #2
index\LIST_NoteA9.txt	Journal Entry From Sanchez #6
index\LIST_NoteAA.txt	A codex of island Medicines
index\LIST_NoteBB.txt	A List of Basic Medicinal Plants
index\LIST_NoteCC.txt	Document on the Synthesis of Muscle Emphasis Drug
index\LIST_NoteDD.txt	Document on the Synthesis of Endurance Emphasis Drug	Mislabeled as Muscle Emphasis in game - fixed by community patch
index\LIST_NoteEE.txt	A List of Adrenaline Stimulants
index\LIST_NoteFF.txt	A Document about a Mental Clarity Tonic
index\LIST_NoteGG.txt	A Document about Anti-Hallucination Medicine
index\LIST_NoteHH.txt	A Document about Potency Enhancers
index\LIST_NoteII.txt	Photos of Chancellor Kallas
index\LIST_NoteJJ.txt	Photos of Plague Victims
index\LIST_NoteKK.txt	A Stack of Photos and Newspaper Clippings
index\LIST_NoteLL.txt	Instructions for Synthesizing Medicines
index\LIST_NoteMM.txt	A Pair of Island Photographs
index\LIST_NoteNN.txt	A Message in a Bottle
index\LIST_NoteOO.txt	Instructions for Researching Plants
index\LIST_NotePP.txt	A Plague Photo and Newspaper Article
index\LIST_NoteQQ.txt	A Photo and Article about Chancellor Kallas
index\LIST_NoteRR.txt	A Map to a Boat Landing
index\LIST_NoteSS.txt	A Document about Owl Statues
index\LIST_NoteTT.txt	A Document on Mapping and Cartography
index\LIST_NoteUU.txt	Instructions for Brain Emphasis Drug
index\LIST_NoteVV.txt	Journal Entry from Doctor Sanchez #5
index\LIST_NoteWW.txt	Journal Entry from Doctor Sanchez #4
index\LIST_NoteXX.txt	Journal Entry from Doctor Sanchez #3
index\LIST_NoteYY.txt	Journal Entry from Doctor Sanchez #2
index\LIST_NoteZZ.txt	Journal Entry from Doctor Sanchez #1

Part 2B: Journal Plants/Research Index & Filename Reference

This section lists all the journal index entries for plant discovery and research. It is also a good reference to look up which plant corresponds with which filename.

• The filename for the matching plant page in the journal will have the same number, but with "Plant" instead of "LIST" and no a/b suffix.
  
• The filename for the matching research page in the journal will also have the same number, but with "RESEARCH" instead of "LIST" and no a/b suffix.

Plants/Research

Text file	English Text
index\LIST_TITLE_Research.txt	Plant Research and Experimentation:
index\LIST_NoResult.txt	No Useful Medicinal Agent was Synthesized.
index\LIST_00a.txt	I discovered a Violet Cactus
index\LIST_00b.txt	I performed research on the Violet Cactus
index\LIST_0a.txt	I discovered a Prickly Pear
index\LIST_0b.txt	I performed research on the Prickly Pear
index\LIST_1a.txt	I discovered a Common White Mushroom
index\LIST_1b.txt	I performed research on the Common White Mushroom
index\LIST_2a.txt	I discovered a Pawn-Shaped Mushroom
index\LIST_2b.txt	I performed research on the Pawn-Shaped Mushroom
index\LIST_3a.txt	I discovered a Red Poisonous Mushroom
index\LIST_3b.txt	I performed research on the Red Poisonous Mushroom
index\LIST_4a.txt	I discovered a Pearl-Blue Shelf Fungus
index\LIST_4b.txt	I performed research on the Pearl-Blue Shelf Fungus
index\LIST_5a.txt	I discovered Yellow Mushrooms
index\LIST_5b.txt	I performed research on the Yellow Mushrooms
index\LIST_6a.txt	I discovered Grey Shelf Fungus
index\LIST_6b.txt	I performed research on the Grey Shelf Fungus
index\LIST_7a.txt	I discovered a Brown Shelf Fungus
index\LIST_7b.txt	I performed research on the Brown Shelf Fungus
index\LIST_8a.txt	I discovered a Sponge-Like Fungus
index\LIST_8b.txt	I performed research on the Sponge-Like Fungus
index\LIST_9a.txt	I discovered a Wood Gill Fungus
index\LIST_9b.txt	I performed research on the Wood Gill Fungus
index\LIST_10a.txt	I discovered a Trumpet Mushroom
index\LIST_10b.txt	I performed research on the Trumpet Mushroom
index\LIST_11a.txt	I discovered a White Spiked Prairie Flower
index\LIST_11b.txt	I performed research on the White Spiked Prairie Flower
index\LIST_12a.txt	I discovered a Purple-White Prairie Flower
index\LIST_12b.txt	I performed research on the Purple-White Prairie Flower
index\LIST_13a.txt	I discovered a Orange Prairie Flower
index\LIST_13b.txt	I researched the Orange Prairie Flower
index\LIST_14a.txt	I discovered a White Bundle Prairie Flower
index\LIST_14b.txt	I researched the White Bundle Prairie Flower
index\LIST_15a.txt	I discovered a Sunflower Variant
index\LIST_15b.txt	I researched the Sunflower Variant
index\LIST_16a.txt	I discovered an Indigo Asteraceae
index\LIST_16b.txt	I performed research on the Indigo Asteraceae
index\LIST_17a.txt	I discovered a Red and Yellow Hibiscus
index\LIST_17b.txt	I performed research on the Red and Yellow Hibiscus
index\LIST_18a.txt	I discovered a White/Pink Viola
index\LIST_18b.txt	I performed research on the White/Pink Viola
index\LIST_19a.txt	I discovered a Blue-Capped Mushroom
index\LIST_19b.txt	I performed research on the Blue-Capped Mushroom
index\LIST_20a.txt	I discovered a Red and Green Tree-Fungus
index\LIST_20b.txt	I performed research on the Red and Green Tree-Fungus
index\LIST_21a.txt	I discovered a Fleshy Rooted Plant
index\LIST_21b.txt	I performed research on the Fleshy Rooted Plant
index\LIST_22a.txt	I discovered a Pink Spotted Lily
index\LIST_22b.txt	I performed research on the Pink Spotted Lily
index\LIST_23a.txt	I discovered a Rainbow Orchid
index\LIST_23b.txt	I performed research on the Rainbow Orchid
index\LIST_24a.txt	I discovered a Titan Plant
index\LIST_24b.txt	I performed research on the Titan Plant
index\LIST_25a.txt	I discovered a Giant Bloom
index\LIST_25b.txt	I performed research on the Giant Bloom
index\LIST_26a.txt	I discovered a Bulbous, Fruit Plant
index\LIST_26b.txt	I performed research on the Bulbous, Fruit Plant
index\LIST_27a.txt	I discovered a Carnivorous Pitcher Plant
index\LIST_27b.txt	I performed research on the Carnivorous Pitcher Plant
index\LIST_28a.txt	I discovered a Carnivorous Trap Plant
index\LIST_28b.txt	I performed research on the Carnivorous Trap Plant
index\LIST_29a.txt	I discovered a Fabaceae
index\LIST_29b.txt	I performed research on the Fabaceae
index\LIST_30a.txt	I discovered a Bio Luminescent Algae
index\LIST_30b.txt	I performed research on the Bio-Luminescent Algae
index\LIST_31a.txt	I discovered a Blue Scaley Tree Fungus
index\LIST_31b.txt	I performed research on the Blue Scaley Tree Fungus
index\LIST_32a.txt	I discovered a Large Jungle Flower
index\LIST_32b.txt	I performed research on the Large Jungle Flower
index\LIST_33a.txt	I discovered a Tropical Buttercup
index\LIST_33b.txt	I performed research on the Tropical Buttercup
index\LIST_34a.txt	I discovered a Fleshy Purple Fruit
index\LIST_34b.txt	I performed research on the Fleshy Purple Fruit

Part 2C: Journal Drugs Index & Filename Reference

This section lists the journal index entries for all of the drug research pages.

The filename for the corresponding journal entry uses the same letter, but has "Plant" (Yes, "Plant", not "Drug") instead of "LIST".

Drugs

Text file	English Text	Notes
index\LIST_A.txt	I successfully synthesized: <span color="#008000">Endurance Emphasis Drug</span>	Use Pango markup for green text
index\LIST_B.txt	I successfully synthesized: <span color="#008000">Muscle Emphasis Drug</span>	Use Pango markup for green text
index\LIST_C.txt	I successfully synthesized: <span color="#0000c0">Basic Medicine</span>	Use Pango markup for blue text
index\LIST_D.txt	I successfully synthesized: <span color="#0000c0">Extra Strength Medicine</span>	Use Pango markup for blue text
index\LIST_E.txt	I successfully synthesized: <span color="#0000c0">Mental Stimulant</span>	Use Pango markup for blue text
index\LIST_F.txt	I successfully synthesized: <span color="#0000c0">Energy Stimulant</span>	Use Pango markup for blue text
index\LIST_H.txt	I successfully synthesized: <span color="#0000c0">Clarity Tonic</span>	Use Pango markup for blue text
index\LIST_I.txt	I successfully synthesized: <span color="#0000c0">Herculean Tonic</span>	Use Pango markup for blue text
index\LIST_J.txt	I successfully synthesized: <span color="#0000c0">Brain Emphasis Drug</span>	Use Pango markup for blue text
index\List_K.txt	I successfully synthesized: <span color="#e00000">The Cure</span>	Use Pango markup for red text
index\LIST_X.txt	I successfully synthesized: <span color="#ff0000">Agent X: Primary Antibiotic</span>	Use Pango markup for red text
index\LIST_Y.txt	I successfully synthesized: <span color="#ff0000">Agent Y: The Anti-Toxin</span>	Use Pango markup for red text
index\LIST_Z.txt	I successfully synthesized: <span color="#ff0000">Agent Z: The Adjuvent</span>	Use Pango markup for red text
index\LIST_IAmCured.txt	I Am Cured	I don't think this is used in-game

Part 2D: Blackboards

The three blackboards textures are the only textures that I do entirely by hand with my graphics tablet to maintain the hand-written aesthetic. Because of this it will likely take me longer to get around to doing them, so you should make sure you send me their translations early on to give me plenty of time.

Text file	English Text
blackboards\Blackboard_YouAreBeingWatched.txt	You are being watched
blackboards\Blackboard_ whoisboters .txt	Who are you? Am I ........?
blackboards\Blackboard_ DidIkillthem .txt	Look at your hands. Did I Kill them?

Part 2E: Journal Front Page

This section lists all the text we need to completely translate the front page of the journal, including the status conditions, medicine tags, objectives and journal tabs.

Journal Tabs

Text file	English Text
tabs\TABS_Status.txt	STATUS
tabs\TABS_Notes.txt	NOTES
tabs\TABS_Lab.txt	RESEARCH

Medicine Tags

Text file	English Text	Notes
items\Tags.txt	Basic Medicine Ex-Strength Medicine Energy Stimulant Mental Stimulant Herculean Tonic Clarity Tonic Anti-Psycho Tonic	One per line Anti-Psycho Tonic can be omitted - it's not used in game.

Status Conditions

Text file	English Text	Notes
conditions\Condition_Primary_Placeholder.txt	Health: OK
conditions\Condition_Primary_Ok.txt	Health: OK
conditions\Condition_Primary_Poor.txt	Health: <span color="#800000">Poor</span>	Use Pango markup for dark red text.
conditions\Condition_Primary_Dire.txt	Health: <span color="#800000">Dire</span>	Use Pango markup for dark red text.
conditions\Condition_Primary_Cured.txt	Health: <span color="#008000">Cured</span>	Use Pango markup for green text.
conditions\Condition_A_Fever.txt	Fever. Use medicine.	Do not use Pango markup.
conditions\Condition_A_HighFever.txt	High Fever! Use medicine soon.	Do not use Pango markup.
conditions\Condition_B_Dehydration.txt	Dehydration. Find water.	Do not use Pango markup.
conditions\Condition_B_ExtremeDehydration.txt	Dehydration! Find water soon.	Do not use Pango markup.
conditions\STATUS_LeftPage.txt	Abilities:
conditions\Condition_Strength_Poor.txt	Strength: Low
conditions\Condition_Strength_Normal.txt	Strength: Normal
conditions\Condition_Strength_Excellent.txt	Strength: High
conditions\Condition_HerculeanTonic_Active.txt	HT	Two letter abbreviation of Herculean Tonic
conditions\Condition_Endurance_Poor.txt	Endurance: Low
conditions\Condition_Endurance_Normal.txt	Endurance: Normal
conditions\Condition_Endurance_Excellent.txt	Endurance: High
conditions\Condition_AdrenalineStimulant_Active.txt	ES	Two letter abbreviation of Energy Stimulant
conditions\Condition_Perception_Poor.txt	Perception: Low
conditions\Condition_Perception_Normal.txt	Perception: Normal
conditions\Condition_Perception_Excellent.txt	Perception: High
conditions\Condition_MentalStimulant_Active.txt	MS	Two letter abbreviation of Mental Stimulant
conditions\Condition_ClarityTonic_Active.txt	Clarity Tonic is active!

Objectives

• There's a pretty limited amount of space on the OBJNOTE images. My script will automatically reduce the font size until the text fits so you do have a little extra breathing room.
  
• The OBJNOTE images are links to particular notes or research entries. The note/plant they refer to can be determined by looking at the last part of the filename (except OBJNOTE_D_11 as noted).
  
• You should include the trailing comma in the OBJNOTE entries.

Text file	English Text	Notes
objectives\OBJECTIVE_A_Placeholder.txt	Discover the Plague Cure
objectives\OBJECTIVE_A.txt	Aquire (sic) the 3 Bio-Chemical agents that comprize the Plague Cure: Tricordrazine
objectives\OBJNOTE_A_0.txt	Bloody Letter,
objectives\OBJECTIVE_B.txt	Agent X: The Antibiotic
objectives\OBJNOTE_B_13.txt	Plant-X Note,
objectives\OBJNOTE_B_15.txt	Synthesis Inst,
objectives\OBJNOTE_B_16.txt	BlueFungiNote,
objectives\OBJNOTE_B_Plant26.txt	Plant-X Lab,
objectives\OBJNOTE_B_Plant31.txt	BlueFung Lab,
objectives\OBJECTIVE_C.txt	Agent Y: The Anti-Toxin
objectives\OBJNOTE_C_2.txt	Agent Y Note,
objectives\OBJNOTE_C_3.txt	BioAlgae Map,
objectives\OBJNOTE_C_4.txt	Extract Note,
objectives\OBJNOTE_C_5.txt	OrchadaeMap,
objectives\OBJNOTE_C_Plant23.txt	Orchadae Lab,
objectives\OBJNOTE_C_Plant30.txt	BioAlgae Lab,
objectives\OBJECTIVE_D.txt	Agent Z: The Adjuvent
objectives\OBJNOTE_D_7.txt	Aracea Map,
objectives\OBJNOTE_D_9.txt	Isabella Note,
objectives\OBJNOTE_D_10.txt	Synthesis Inst,
objectives\OBJNOTE_D_11.txt	Pitcher Note,	The number is wrong - this refers to NOTE_12
objectives\OBJNOTE_D_12.txt	Pitcher Note,	English texture is bad - community patch replaces this with OBJNOTE_D_11
objectives\OBJNOTE_D_17.txt	Pitcher Map,
objectives\OBJNOTE_D_Plant24.txt	Aracea Lab,
objectives\OBJNOTE_D_Plant27.txt	Pitcher Lab,
objectives\OBJECTIVE_E.txt	Escape Eden
objectives\OBJNOTE_E_RR.txt	Boat Landing,
objectives\OBJECTIVE_F.txt	Synthesize the Endurance Emphasis Drug
objectives\OBJNOTE_F_A3.txt	Plants Map,
objectives\OBJNOTE_F_DD.txt	Synthesis Inst,
objectives\OBJNOTE_F_Plant19.txt	BToadStoLab,
objectives\OBJNOTE_F_Plant25.txt	GiaBloom Lab,
objectives\OBJECTIVE_G.txt	Synthesize the Muscle Emphasis Drug
objectives\OBJNOTE_G_A2.txt	Plants Map,
objectives\OBJNOTE_G_CC.txt	Synthesis Inst,
objectives\OBJNOTE_G_Plant32.txt	JunFlower Lab,
objectives\OBJNOTE_G_Plant34.txt	PurpFruit Lab,
objectives\OBJECTIVE_H.txt	Synthesize the Brain Emphasis Drug
objectives\OBJNOTE_H_A4.txt	Plants Map,
objectives\OBJNOTE_H_UU.txt	Synthesis Inst,
objectives\OBJNOTE_H_Plant10.txt	SpongeFu Lab,
objectives\OBJNOTE_H_Plant8.txt	TrumFung Lab,
objectives\STATUS_RightPage.txt	Primary Objectives: Secondary Objectives:	One per line

Part 2F: Intro, Ending & Credits

I'm not auto-wrapping the intro in the script (I do auto-wrap the ending), so insert a newline at an appropriate place for the longer text - I can tweak it if it overflows.

Intro

Text file	English Text
intro\Intro_A.txt	In a different place and time...
intro\Intro_B.txt	Your name is Robert Hughes.
intro\Intro_C.txt	You awake on the shores of a mysterious island.
intro\Intro_D.txt	You have come to the island an exiled man: a traitor and betrayed.
intro\Intro_E.txt	You are suffering from a plague: a disease from which you soon will die
intro\Intro_F.txt	The island is home to a research outpost: a conclave of enlightened men searching for a cure.
intro\Intro_G.txt	Discover the cure and survive.

If you have extracted the game files yourself you can the ones I'm not spoiling under TEX\MENU, or I will have given you the URL to them. Or finish the game and take screenshots.

Ending

Text file	English Text	Notes
end\End1_A.txt		Not going to spoil this one
end\End1_B.txt		Not going to spoil this one
end\End1_C.txt		Not going to spoil this one
end\End1_D.txt	The End
end\End1_F.txt	Technical Programming, Engine Design, Toolset Design, Music Joe Johnson	Use three lines - the script takes care of the formatting
end\End1_G.txt	Creative Art, Animation, World Design, Story, Music Bob Johnson	Use three lines - the script takes care of the formatting
end\End1_G_modA.txt	<LANGUAGE> Translation Translation <YOUR NAME HERE>	Take a little credit ;-)
end\End1_G_modB.txt	<LANGUAGE> Translation Modding, Textures Ian Munsie	That would be me
end\End1_H.txt	Special Thanks To... Dad and Mom
end\End1_I.txt	Special Thanks To... Our amazingly supportive Friends and Family
end\End1_J.txt	Special Thanks To...	No need to put "Milo" in here
end\End1_K.txt	Thanks for playing!

Part 2G: Plants, Research & Drugs Journal Entries

These three categories all work in roughly the same way - each of them has a "template.txt" with the text for the page title and headings, then individual text files for each page.

The English text for these can be found under TEX\J2 after extracting the game files, or at a URL I can provide if you get in touch.

Plants

Create a text file plants\template.txt and fill it in like this:

Specimen Observation
Name:
Genus:
Observations:

For each plant, create a text file plants\Plant_<NUMBER>.txt and place the name on the first line, the Genus on the second line (or leave a blank line if unknown) and the observations on the lines below that.

You should end up with these files (Refer to Part 2B to work out which filename is which plant):

plants\template.txt, plants\Plant_00.txt, plants\Plant_0.txt, plants\Plant_1.txt, plants\Plant_2.txt, plants\Plant_3.txt, plants\Plant_4.txt, plants\Plant_5.txt, plants\Plant_6.txt, plants\Plant_7.txt, plants\Plant_8.txt, plants\Plant_9.txt, plants\Plant_10.txt, plants\Plant_11.txt, plants\Plant_12.txt, plants\Plant_13.txt, plants\Plant_14.txt, plants\Plant_15.txt, plants\Plant_16.txt, plants\Plant_17.txt, plants\Plant_18.txt, plants\Plant_19.txt, plants\Plant_20.txt, plants\Plant_21.txt, plants\Plant_22.txt, plants\Plant_23.txt, plants\Plant_24.txt, plants\Plant_25.txt, plants\Plant_26.txt, plants\Plant_27.txt, plants\Plant_28.txt, plants\Plant_29.txt, plants\Plant_30.txt, plants\Plant_31.txt, plants\Plant_32.txt, plants\Plant_33.txt, plants\Plant_34.txt

Research

Create a text file research\template.txt and fill it in like this:

Laboratory Research
My Conclusion:

The Prickly Pear cactus and right hand page of the cure doesn't fit the same pattern as the rest of the research entries, so create a text file research\RESEARCH_0.txt and fill it in with the translation of:

My tests on this plant have
revealed no medicinal value

Create a text file research\Research_K.txt (yes, different capitalisation on this one) and fill it in with the translation of this, using the same colour in the Pango markup to match the slightly darker red from the English version:

I have succesfully (sic) administered the Tricordrazine. <span color="#a50018">My plague has been cured!</span> All symptoms have subsided and my physical capacity has been fully restored.

For all the remaining research entries, create two text files research\RESEARCH_<NUMBER>.txt and research\RESEARCH_<NUMBER>_conclusion.txt

Fill the first in with the translation of the scientific method (i.e. the grey text). Leave blank lines between paragraphs, but don't worry about having to wrap the text around the diagrams - my script will do that automatically.

Fill the second in with the translation of the conclusion. Use Pango markup to highlight drug names and hints in red, like this:

If this fungus is <span color="#ff0000">combined with a Type-C Poison inhibitor</span>, I will be able to synthesize it into a <span color="#ff0000">Brain Emphasis Drug.</span>

You should end up with all these files (refer to Part 2B to work out which filename is which plant):

research\template.txt, research\RESEARCH_00_conclusion.txt, research\RESEARCH_00.txt, research\RESEARCH_0.txt, research\RESEARCH_1_conclusion.txt, research\RESEARCH_1.txt, research\RESEARCH_2_conclusion.txt, research\RESEARCH_2.txt, research\RESEARCH_3_conclusion.txt, research\RESEARCH_3.txt, research\RESEARCH_4_conclusion.txt, research\RESEARCH_4.txt, research\RESEARCH_5_conclusion.txt, research\RESEARCH_5.txt, research\RESEARCH_6_conclusion.txt, research\RESEARCH_6.txt, research\RESEARCH_7_conclusion.txt, research\RESEARCH_7.txt, research\RESEARCH_8_conclusion.txt, research\RESEARCH_8.txt, research\RESEARCH_9_conclusion.txt, research\RESEARCH_9.txt, research\RESEARCH_10_conclusion.txt, research\RESEARCH_10.txt, research\RESEARCH_11_conclusion.txt, research\RESEARCH_11.txt, research\RESEARCH_12_conclusion.txt, research\RESEARCH_12.txt, research\RESEARCH_13_conclusion.txt, research\RESEARCH_13.txt, research\RESEARCH_14_conclusion.txt, research\RESEARCH_14.txt, research\RESEARCH_15_conclusion.txt, research\RESEARCH_15.txt, research\RESEARCH_16_conclusion.txt, research\RESEARCH_16.txt, research\RESEARCH_17_conclusion.txt, research\RESEARCH_17.txt, research\RESEARCH_18_conclusion.txt, research\RESEARCH_18.txt, research\RESEARCH_19_conclusion.txt, research\RESEARCH_19.txt, research\RESEARCH_20_conclusion.txt, research\RESEARCH_20.txt, research\RESEARCH_21_conclusion.txt, research\RESEARCH_21.txt, research\RESEARCH_22_conclusion.txt, research\RESEARCH_22.txt, research\RESEARCH_23_conclusion.txt, research\RESEARCH_23.txt, research\RESEARCH_24_conclusion.txt, research\RESEARCH_24.txt, research\RESEARCH_25_conclusion.txt, research\RESEARCH_25.txt, research\RESEARCH_26_conclusion.txt, research\RESEARCH_26.txt, research\RESEARCH_27_conclusion.txt, research\RESEARCH_27.txt, research\RESEARCH_28_conclusion.txt, research\RESEARCH_28.txt, research\RESEARCH_29_conclusion.txt, research\RESEARCH_29.txt, research\RESEARCH_30_conclusion.txt, research\RESEARCH_30.txt, research\RESEARCH_31_conclusion.txt, research\RESEARCH_31.txt, research\RESEARCH_32_conclusion.txt, research\RESEARCH_32.txt, research\RESEARCH_33_conclusion.txt, research\RESEARCH_33.txt, research\RESEARCH_34_conclusion.txt, research\RESEARCH_34.txt, research\Research_K.txt

Drugs

Create a text file drugs\template.txt and fill it in like this:

Biochemical Research
Name:
Function:

For each drug, create a text file drugs\Plant_<LETTER>.txt and place the name on the first line and the description on the lines below that. You can leave a blank line after the name if you wish - the script will ignore it. Blank lines within the body of the description are preserved.

You should end up with these files (refer to Part 2C to work out which filename is which drug):

drugs\template.txt, drugs\Plant_A.txt, drugs\Plant_B.txt, drugs\Plant_C.txt, drugs\Plant_D.txt, drugs\Plant_E.txt, drugs\Plant_F.txt, drugs\Plant_H.txt, drugs\Plant_I.txt, drugs\Plant_J.txt, drugs\Plant_K.txt, drugs\Plant_X.txt, drugs\Plant_Y.txt, drugs\Plant_Z.txt

Part 2H: Notes - Simple, 0-18 & A1-A9

Each of the notes have slightly different rules as to where they expect the translated text because they are all so different. Generally there is a separate text file for each distinct block of text, but check the descriptions below!

If you have extracted the game's files these are all under TEX\J2, if you are looking at my site they are all under notes.

Common Files

Text file	English Text	Notes
notes\primary_materials.txt	Primary Materials:	Used in notes CC, DD & UU
notes\synthesis_of.txt	Synthesis of:	Used in notes CC, DD & UU
notes\statue.txt	Statue	Used in notes 2 and A1
notes\sirius.txt	Sirius	Used in notes 7 and 8

Simple (Single File) Notes

Text file	Description
notes\NOTE_1.txt
notes\NOTE_4.txt	Body of the letter. NOTE: This letter cannot be found in the game.
notes\NOTE_7.txt	Body of the letter. "Sirius" is read from sirius.txt (preserves case), "Rigel" is left unchanged.
notes\NOTE_8.txt	"Region Map: Outpost Sirius". "SIRIUS" is read from sirius.txt (ignores case), S1 is left unchanged.
notes\NOTE_14.txt	"Region Map: Outpost Tau"
notes\NOTE_A2.txt	One per line: "Large Jungle Flower" "Fleshy Purple Fruit"
notes\NOTE_A3.txt	One per line: "Blue-Capped Mushroom" "Giant Bloom"
notes\NOTE_A4.txt	One per line: "Sponge-Like Mushroom" "Trumpet Mushroom"
notes\NOTE_A6.txt	One per line: "Camp" "Swamp Trail"
notes\NOTE_A9.txt	The script will automatically split the text over both pages
notes\NOTE_BB.txt	Main body of the note. All the plant names on the right hand page are automatically fetched out of the plants directory by the script.
notes\NOTE_EE.txt	Left hand page body. Plant names on the right hand page are automatically fetched from elsewhere.
notes\NOTE_FF.txt	Right hand page body. Plant names on the left hand page are automatically fetched from elsewhere.
notes\NOTE_GG.txt	Right hand page body. Plant names are automatically fetched from elsewhere. There is some debate as to whether the text should be expanded to indicate that the anti-hallucination medicine cannot be synthesized.
notes\NOTE_HH.txt	Left hand page body. Plant names are automatically fetched from elsewhere.
notes\NOTE_YY.txt	The script will automatically split the text over both pages
notes\NOTE_WW.txt	The script will automatically split the text over both pages

Notes

Text file	Description
notes\NOTE_0.txt	Main body of the letter. Use Pango markup <span color="#102080">...</span> around Agent X/Y/Z bullet list to get the right colour. Copy this unicode character for the best results rendering the bullet points: ·
notes\NOTE_0_cure.txt	"The Cure" "Tricordrazine"
notes\NOTE_0_X.txt	"Agent X" "Primary Antibiotic"
notes\NOTE_0_Y.txt	"Agent Y" "Anti-Toxin"
notes\NOTE_0_Z.txt	"Agent Z" "Adjuvant"

Text file	Description
notes\NOTE_2.txt	Main body of the letter. Use Pango markup to underline emphasised text, like <span underline="single" underline_color="#ff0000">this</span>. There's no easy way to script circling Agent Y, so just underline it as well.
notes\NOTE_2_title.txt	"Map to Outpost Vega"

Text file	Description
notes\NOTE_3.txt	Main body of the note
notes\NOTE_3_algae.txt	"Algae"
notes\NOTE_3_ruin_site_b.txt	"Ruin Site B"
notes\NOTE_3_title.txt	"Map to Bio-luminescent Algae"

Text file	Description
notes\NOTE_5.txt	Body of the letter
notes\NOTE_5_title.txt	"Region of Orchadae-Helius"

Text file	Description
notes\NOTE_10.txt	Left hand page of the note starting with "Summary:"
notes\NOTE_10_rh.txt	Right hand page of the note. Don't include any Pango markup here.
notes\NOTE_10_title.txt	"Synthesis of Agent Z"

Text file	Description
notes\NOTE_11.txt	"Region Map: Outpost Rigel"
notes\NOTE_11_to_sirius.txt	"to SIRIUS"

Text file	Description
notes\NOTE_15.txt	Left hand page of the note starting with "Summary:"
notes\NOTE_15_rh.txt	Right hand page of the note. Use Pango markup <span color="#f00000">...</span> to highlight words
notes\NOTE_15_title.txt	"Synthesis of Agent X"

Text file	Description
notes\NOTE_16.txt	Main body of the note, excluding the sign off
notes\NOTE_16_ozwaldt.txt	"-Ozwaldt"

Text file	Description
notes\Note_A1.txt	"Map of Outpost Draco". Note that "Statue" is read from statue.txt
notes\Note_A1_lab.txt	"Laboratory"

Text file	Description
notes\NOTE_A5.txt	Main body of the note after the title
notes\NOTE_A5_title.txt	Title - Add a newline after 'Mapping Document B', but don't worry about one in the middle of the "How to..." line - the script will wrap it automatically
notes\NOTE_A5_landmark.txt	"Landmark"
notes\NOTE_A5_vantage_1.txt	"Vantage Point #1" - Add a newline
notes\NOTE_A5_vantage_2.txt	"Vantage Point #2" - Add a newline

Part 2H (cont): Notes AA-ZZ

I had to split this section in two because of the character limit. Some notes (simple single file ones) are in the previous section, as are some common files that are used by multiple notes.

Text file

notes\NOTE_AA_basic_medicine.txt

notes\NOTE_AA_brain_emphasis.txt

notes\NOTE_AA_clarity_tonic.txt

notes\NOTE_AA_endurance_emphasis.txt

notes\NOTE_AA_energy_stim.txt

notes\NOTE_AA_herculean_tonic.txt

notes\NOTE_AA_mental_stim.txt

notes\NOTE_AA_muscle_emphasis.txt

For all of the text files in note AA, the name of the drug goes on the first line and the description goes on the second.

Text file	Description
notes\NOTE_CC.txt	Main body of the left hand page. "Synthesis of", "Primary Materials" and the two plant names are automatically fetched from elsewhere.
notes\NOTE_CC_title.txt	"Muscle Emphasis Drug"

Text file	Description
notes\NOTE_DD.txt	Main body of the left hand page. "Synthesis of" is fetched from synthesis_of.txt
notes\NOTE_DD_title.txt	Right hand page starting with "Secondary Materials". Note that "Primary Materials" and the two plant names are automatically fetched from elsewhere.
notes\NOTE_DD_rh.txt	"Endurance Emphasis Drug"

Text file	Description
notes\NOTE_II.txt	Caption under photo on left page
notes\NOTE_II_rh.txt	Caption under photo on right page

Text file	Description
notes\NOTE_JJ.txt	Caption under photo on left page
notes\NOTE_JJ_rh.txt	Caption under photo on right page

Text file	Description
notes\NOTE_KK.txt	Caption under photo on right page
notes\NOTE_KK_clip1_heading.txt	Left hand newspaper clipping headline
notes\NOTE_KK_clip1.txt	Left hand newspaper clipping body
notes\NOTE_KK_clip2_heading.txt	Right hand newspaper clipping headline
notes\NOTE_KK_clip2.txt	Right hand newspaper clipping body
notes\NOTE_KK_under.txt	Part of another newspaper article that has been cut off and obscured by the second clipping. Add newlines and we can play around with the whitespace to make it look convincing.

Text file	Description
notes\NOTE_LL.txt	Left hand page body ending with "Place one plant on 'Tray A'.". Use Pango <u>...</u> tags to underline headings
notes\NOTE_LL_or.txt	"or"
notes\NOTE_LL_b.txt	Left hand page body starting with "Place one plant on 'Tray A' AND a..."
notes\NOTE_LL_rh.txt	Right hand page body. Use Pango <u>...</u> tags to underline Step 3 heading
notes\NOTE_LL_step1.txt	"1. Place Plant(s) here" "Tray B Tray A"
notes\NOTE_LL_step2.txt	"2. Initiate Synthesis" "Distillation Rig"
notes\NOTE_LL_step3.txt	"3. Take Meds" "Yield Tray"

Text file	Description
notes\NOTE_MM.txt	Caption under the photo on the left
notes\NOTE_MM_rh.txt	Caption under the photo on the right

Text file	Description
notes\NOTE_OO.txt	Body of the note. Use Pango <u>...</u> tags to underline headings
notes\NOTE_OO_step1.txt	"1. Place plant here:" "Examination Tray"
notes\NOTE_OO_step2.txt	"2. Initiate Research here:" "Microscope"

Text file	Description
notes\NOTE_PP.txt	Caption under the photo on the right
notes\NOTE_PP_clip_heading.txt	Newspaper clipping headline
notes\NOTE_PP_clip.txt	Newspaper clipping body

Text file	Description
notes\NOTE_QQ.txt	Caption under the photo on the right
notes\NOTE_QQ_newspaper_name.txt	"The Daily Chronicle"
notes\NOTE_QQ_clip_heading.txt	Newspaper clipping headline
notes\NOTE_QQ_clip.txt	Newspaper clipping body

Text file	Description
notes\NOTE_RR_boat.txt	"Boat Landing"
notes\NOTE_RR_causeway.txt	"Causeway"

Text file	Description
notes\NOTE_TT_title.txt	Title. Add a newline after "Mapping Document A", but don't worry about splitting the next line
notes\NOTE_TT_step1.txt	Text at Step 1
notes\NOTE_TT_step2.txt	Text at Step 2
notes\NOTE_TT_rh.txt	Right hand body - step 2 continued and step 3
notes\NOTE_TT_statue.txt	"A. statue"
notes\NOTE_TT_tent.txt	"B. tent"
notes\NOTE_TT_cabin.txt	"C. cabin"
notes\NOTE_TT_you_are_here.txt	"You are here"

Text file	Description
notes\NOTE_UU.txt	Left hand page body. Note that "synthesis of", "Primary Materials" and the two plant names are fetched from elsewhere.
notes\NOTE_UU_title.txt	"Brain Emphasis Drug"

Text file	Description
notes\NOTE_VV.txt	Left hand body, starting with "May 13, 1912"
notes\NOTE_VV_rh.txt	Right hand body, starting with "May 16, 1912"

Text file	Description
notes\NOTE_XX.txt	Left hand body, starting with "March 18, 1911"
notes\NOTE_XX_rh.txt	Right hand body, starting with "March 23, 1911"

Text file	Description
notes\NOTE_ZZ.txt	Left hand body, starting with "May 23, 1912"
notes\NOTE_ZZ_rh.txt	Caption under the photo on the right

Part 2I: Map

This section includes the text that gets overlayed on the map if the corresponding map fragment has been found (however a few of these do not appear to be on any map fragments):

Text file	Description
maps\boat_landing.txt	"Boat Landing"
maps\outpost_draco.txt	"Outpost Draco"
maps\outpost_polaris.txt	"Outpost Polaris"
maps\outpost_rigel.txt	"Outpost Rigel"
maps\outpost_sirius.txt	"Outpost Sirius"
maps\outpost_tau.txt	"Outpost Tau"
maps\outpost_vega.txt	"Outpost Vega"
maps\ruin_a.txt	"Ruin Site A" (AFAIK Never uncovered in the game)
maps\ruin_b.txt	"Ruin Site B"
maps\ruin_c.txt	"Ruin Site C" (AFAIK Never uncovered in the game)

Part 2J: Misc

This section contains the textures that didn't fit anywhere else.

Text file	Description
buttons\yes.txt	"YES" displayed in some menus. There's not much space to work with here, but we could always use a tick if necessary.
buttons\no.txt	"NO" displayed in some menus. There's not much space to work with here, but we could always use a cross if necessary.
copyright.txt	Copyright message displayed on the main menu. Copy & paste the unicode copyright symbol and credit yourself :-) The span here is just to space things out a bit nicer: By Joe Johnson and Bob Johnson ©copyright 2012 IonFx<span size="8192"> </span>LANGUAGE translation by <YOUR NAME HERE> &amp; Ian Munsie
items\Lab_SampleTrays.txt	Lab trays. Leave a blank line between each. The script will wrap them automatically, but newlines can be added to force wrapping, as in tray A below: SYNTHESIS TRAY B SYNTHESIS TRAY A SPECIMEN STORAGE BIN EXAMINATION TRAY
items\Lab_DarkBottle.txt	Some of the bottles found in the labs. One per line using Pango markup to render the 2 in subscript: phosphoric acid distilled H<span rise="-3072" size="10240">2</span>O
items\Lab_BlueBottle.txt	Some of the bottles found in the labs. One per line: Potassium Phosphate Calcium Acetate

Part 3: Patcher

When we are getting ready to release a translation we need the patcher itself to be translated. To do this download Qt Linguist from here:

http://qt-apps.org/content/show.php/Qt+Linguist+Download?content=89360

Then grab a copy of the translation source file:

https://raw.githubusercontent.com/DarkStarSword/miasmata-fixes/master/miaspatch_i18n/miaspatch-template.ts

You will also need a version of the patcher that supports the translation to try it out. The patcher bundled with the community patch v1.2.1 contains the necessary bug fixes, so you can use that.

Use Qt Linguist to edit the translations in the .ts file. It's not necessary to translate absolutely everything in the patcher - the important bits are the parts of the UI that someone needs to read to understand what they are doing, while things like error messages and technical jargon are less important. In particular, you definitely will want to translate everything under "Dialog", "MiasPatch", "Mod Status", "PatchListModel", while under "RS5Patcher" you may want to translate the status messages but not bother with the error messages.

To try it out export it to a .qm file in the miaspatch_i18n folder of the patcher. You will need to edit the miaspatch.cfg file in the patcher and set the language to whatever you named the .qm file. The patcher will automatically find any .miasmod and .rs5mod files in it's directory and offer them as choices to install, so you will want to add those generated in parts 1 and 2.

Appendix A: DIY (Advanced!)

This section is only for advanced users only. If you don't know how to run commands from the Linux command line, have never applied a patch and built a piece of software or think that Python is a kind of snake you should probably just let me take care of this part. I'm not going to hold your hand here - if you think you are capable of doing this yourself you should only need fairly minimal instructions.

My scripts are all on github - clone them with:

git clone git:/github.com/DarkStarSword/miasmata-fixes

Download the source code for the GIMP, apply the patch attached to this bug report and build it:
https://bugzilla.gnome.org/show_bug.cgi?id=724101

Download and extract my "blank" (removed text) versions of all the textures in the game from here:
http://darkstarsword.net/files/miasmata/miasmata-blanks-2014-04.tar.xz

Purchase or otherwise obtain permission to use the fonts that are used in the game:

• Neu Phollick Alpha (This is the main font used throughout 90% of the game. From Typotheticals - http://www.myfonts.com/foundry/Typotheticals/ . I got in touch with the designer (Graham Meade, fontype <AT> hotmail D.T com) to get permission to use all the Typotheticals fonts in the game)
  
• Norlik (Typotheticals)
  
• Flute (Typotheticals)
  
• Wiki (Typotheticals)
  
• Worstveld Sling (Typotheticals. Free. Not to be confused with Worstveld Sting)
  
• FG Norah - http://www.myfonts.com/fonts/fontgarden/fg-norah/
  
• 23rd Street - http://www.myfonts.com/fonts/albatross/23rd-street/
  
• Architects Daughter (There are two versions of this font with different shapes, you want this one: http://www.fontsquirrel.com/fonts/architects-daughter)
  
• New Yorker - http://www.urbanfonts.com/fonts/New_Yorker.htm (This font is missing accented characters - I used fontforge to add the ones I needed)
  
• OldNewspaperTypes - http://www.dafont.com/oldnewspapertypes.font
  
• Candara (bundled with Windows 7 and above)

Generic looking fonts where I picked whatever I had on my system that looked close enough, but was not an exact match:

• Century Gothic
  
• Georgia
  
• URW Bookman L

Extract the texture headers with:

miasmata-fixes/rs5-extractor.py -xf main.rs5 --chunks --filter IMAG -C miasmata-headers

Optionally delete all extracted files named 02-DATA.dds since we are replacing that part.

Symlink all the .py scripts from miasmata-fixes/translations/scripts/*.py to ~/.gimp-2.8/plug-ins (or ~/.config/GIMP/2.9/plug-ins if running the current development version).

When everything is in place, run the various shell scripts under miasmata-fixes/translations/scripts to generate the translated textures. Some of these need to be told which textures to generate, others do everything in their category at once - if you're reading this you can surely figure out which is which. If you need to make manual tweaks to any of the produced .xcf files save them as xxx_tweaked.xcf and re-run the script (currently only works with miasmata-notes.sh).

Don't forget to manually do the blackboard images! I used Krita - there's some hints for how I did this in the commit message - https://github.com/DarkStarSword/miasmata-fixes/commit/ed7947539bb717ad582055defac1534b4192a29c

Edit the paths at the top of miasmata-fixes/translations/scripts/stage-translation.sh and run it, passing the mod name you want to use (e.g. "french") and a version number (which MiasPatch will display and use to determine if the mod needs to be upgraded).

Package the staging tree into an rs5mod archive with

miasmata-fixes/rs5-extractor.py -cf language.rs5mod staging-tree

You're done! Install the rs5mod with MiasMod or MiasPatch (which picks it up automatically if it's in the miaspatch directory).

[Kastuk]

Ссылка на пак чистых текстур внизу всё ещё работает:
http://valen.darkstarsword.net/files/miasmata/miasmata-blanks-2014-04.tar.xz

А запаковывать, вроде как, python-скриптами, помянутыми в конце руководства наверху.

Возможно, под конец года разработчики что-то опубликуют по своей новой игре и даже, может, выложат инструментарий для редактирования
https://vk.com/miasmata?w=wall-45808175_496

Многие переводчики на русский уже давно сдались от неудобств работы: https://forum.zoneofgames.ru/topic/27275-miasmata/

[Kastuk]

Thanks, now I know much more then before. Just need to find someone, who need results of this work.

[DarkStarSword]

The InWorldNotes_Set* textures are composites - if you use my script it will regenerate them from the high resolution note images, or you can do the same manually once you have finished everything else. They probably won't matter all that much if you leave them though - they are only used to show the notes in the world before picking them up, so most people would never read them anyway.

[Kastuk]

Yep, thanks, extracted with 7zip and Universal Extractor.
Huh, pretty big work with cleaning of papers. Good reason to buy tablet at last.
Hm, part of world notes is blured. https://ctrlv . cz/shots/2017/12/28/FSRR.png
Maybe, must reextract in one turn.

Maybe, mass advancement learning of english will be much more helpful.
Okay, i'm so novice for do it alone. Need someone for passion refueling.

[DarkStarSword]

Yeah, you can start with the blank textures I created and add text over the top of those with whatever program you prefer. My cackle server is long since dead, but there's a mirror of those files here: http://valen.darkstarsword.net/files/miasmata/miasmata-blanks-2014-04.tar.xz

[Kastuk]

I want to draw things myself, like in manga scanlation.
But I haven't that much of Linux skills for mass textures replacement. Will do it half-manually. Maybe, with Photoshop actions.
I don't know much about GIMP, but I draw some comics by this. I much more into PaintNET.

But then is repacking. It's not an unity assets like, as I see...

[DarkStarSword]

Yeah, non-latin would be a problem for everything listed in part 1 since the game uses Windows-1252 encoding. Everything in part 2 are just textures and would be fine, and they do make up the bulk of the text. FYI I have pretty limited time and wouldn't be able to help as much as I have for past translations.

[Kastuk]

There's will be problem with non-latin languages? Menu, tutorial and fonts...
I want try translate to russian.

[coldshadow94]

Hemos completado la traducción al español. La he subido a Dropbox. Aquí está el enlace:

https://www.dropbox.com/s/00g2qv3w04s2ixv/traduccion_miasmata1.exe?dl=0

Si tenéis dudas, dirigíos a la guía que he creado para dejar vuestros comentarios:

http://steamcommunity.com/sharedfiles/filedetails/?id=686531105

Un saludo,
David

[StepanXolera]

Надзвичайно корисно, та на жаль, ніхто з україномовної спільноти не зробив перекладу забавки...