From 06956a4297dabba1b96bbdcd137f8857d45d6fd7 Mon Sep 17 00:00:00 2001
From: Novatux <nathanael.courant@laposte.net>
Date: Fri, 13 Jun 2014 20:24:55 +0200
Subject: [PATCH] Initial commit

---
 .gitignore            |   1 +
 convert.py            |  70 ++++++++++++++++++
 technic_tutorial.html |  47 ++++++++++++
 technic_tutorial.txt  | 161 ++++++++++++++++++++++++++++++++++++++++++
 4 files changed, 279 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 convert.py
 create mode 100644 technic_tutorial.html
 create mode 100644 technic_tutorial.txt
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..b25c15b
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+*~
diff --git a/convert.py b/convert.py
new file mode 100644
index 0000000..e5b0680
--- /dev/null
+++ b/convert.py
@@ -0,0 +1,70 @@
+import sys
+
+def flatten(l):
+    u = []
+    for j in l:
+        for i in j:
+            u.append(i)
+    return u
+
+def closing_tag(tag):
+    u = tag.split("<")[1:]
+    u.reverse()
+    return "</" + "</".join(u)
+
+def make_paragraph(par):
+    # Titles
+    if len(par) >= 2 and par[1] == "=" * len(par[0]):
+        return "<h1>" + par[0] + "</h1>"
+    l = [("<p>", [])]
+    for line in par:
+        if line[:2] == "- ":
+            l.append(("<ul><li>", [line[2:]]))
+        else:
+            l[-1][1].append(line)
+
+    l2 = []
+    for (tag, u) in l:
+        l2.append(tag)
+        l2.append(" ".join(u))
+        l2.append(closing_tag(tag))
+    return "".join(l2)
+
+def process_format(l):
+    ll = [[]]
+    for i in l:
+        if i == "":
+            ll.append([])
+        else:
+            ll[-1].append(i)
+
+    return [make_paragraph(par) for par in ll]
+
+replacements = [("<...>", "<b>TODO</b>"),
+                ("[[", '<img src="'),
+                ("]]", '" width=683 heigth=384>')]
+def process_line(line):
+    for a, b in replacements:
+        line = line.replace(a, b)
+    return line
+
+def process_content(l):
+    return [process_line(line) for line in l]
+
+infile = sys.argv[1]
+outfile = sys.argv[2]
+
+with open(infile, "r") as f:
+    l = f.readlines()
+
+l = [i.strip() for i in l]
+l = process_format(l)
+l = process_content(l)
+
+with open(outfile, "w") as f:
+    f.write("<!DOCTYPE html>\n<html><body>\n")
+    for line in l:
+        f.write(line)
+        f.write("\n")
+    f.write("</body></html>\n")
+
diff --git a/technic_tutorial.html b/technic_tutorial.html
new file mode 100644
index 0000000..bd1144a
--- /dev/null
+++ b/technic_tutorial.html
@@ -0,0 +1,47 @@
+<!DOCTYPE html>
+<html><body>
+<h1>Starting a new game</h1>
+<p>Create a new world, and enable the following mods/modpacks (before entering that world for the first time):</p><ul><li>mesecons</li></ul><ul><li>moreblocks (optional, but needed if you want to use "extranodes")</li></ul><ul><li>moreores</li></ul><ul><li>moretrees</li></ul><ul><li>pipeworks</li></ul><ul><li>plantlife (or at least, plants_lib)</li></ul><ul><li>technic</li></ul><ul><li>unified_inventory</li></ul>
+<p></p>
+<h1>First steps</h1>
+<p><img src="worldcreate.png" width=683 height=384></p>
+<p>So, you've just spawned in a wonderful world, and you're probably wondering about what to do. Do as you would do on any map: dig a few trees (don't trash the leaves, they will be useful later), gather some cobble, craft a basic stone pick, and build your house... There are a few points you need to be careful about though: make your house big enough, and easy to extend, since the industry will need a lot of room, and, more importantly, if you decide to mine immediately, do not smelt any of your ore yet, except three iron lumps to craft an iron pick.</p>
+<p><img src="house.png" width=683 height=384></p>
+<p></p>
+<h1>Time to mine!</h1>
+<p>Now, gather your torches and pickaxes, and let's go down!</p>
+<p><img src="ores1.png" width=683 height=384></p>
+<p>Here you can see from left to right:</p><ul><li>Mese crystals</li></ul><ul><li>Tin</li></ul><ul><li>Iron</li></ul><ul><li>Copper (this is the metal you will most lack - not because it's rare, but because it is the most used one)</li></ul><ul><li>Zinc</li></ul>
+<p><img src="ores2.png" width=683 height=384></p>
+<p>From left to right:</p><ul><li>Iron again</li></ul><ul><li>Coal (don't say it is useless, you will need it...)</li></ul><ul><li>Chromium (generates below -100)</li></ul><ul><li>Gold</li></ul>
+<p>Other ores I haven't shown:</p><ul><li>Uranium, a blue-green ore, only generates between -80 and -300</li></ul><ul><li>Mithril, a deep blue ore, generates below -512</li></ul><ul><li>Silver, a grey ore</li></ul><ul><li>Diamond, but you already know it...</li></ul>
+<p>So, now you know all the ores, gather: <b>TODO</b></p>
+<p>Don't forget that you should not smelt that ore! We will soon see a machine that will be able to produce two ingots for every lump you mine - so if you're too hasty, you will lose metal...</p>
+<h1>Your first electric network</h1>
+<p>Ok, now you can smelt some of your ore... But don't smelt all of it! Here is what you will need: <b>TODO</b></p>
+<p>The base ingredient of electrical circuits is... wires, of course! So, craft <b>TODO</b> wires using the copper ingots.</p>
+<p><img src="craft_lv_wire.png" width=683 height=384></p>
+<p>To run your circuit, you will also need a switching station - it is the component which will handle all the logic. However, building a switching station is expensive: You will need two wires, two copper ingots, four cast iron ingots and a LV transformer. I'm hearing you saying "Cast iron? What's that?", so let me explain a bit.</p>
+<p><img src="craft_switching_station.png" width=683 height=384></p>
+<p>In technic, iron has several forms: the first one is wrought iron, which is basically iron, in its ingot form. The second one is cast iron, which is an alloy of iron and carbon, which high carbon content. To get it, just smelt again an ingot of wrought iron; the carbon in the coal will alloy with the iron and form cast iron. There are two other forms of iron, which we will see later.</p>
+<p><img src="smelt_cast_iron.png" width=683 height=384></p>
+<p>Ok, so now you have to make a LV transformer to build that switching station. But do you know how a transformer is made? It is basically two coils around an iron core. Therefore, you will need seven wrought iron ingots and two coils to make it.</p>
+<p><img src="craft_lv_transformer.png" width=683 height=384></p>
+<p>Finally, the copper coil. Well, it is but fine wire wrapped <... find better word> around some metal ring. To make it you need fine copper wire and <b>TODO</b> iron.</p>
+<p><img src="craft_coil.png" width=683 height=384> <img src="craft_fine_copper_wire.png" width=683 height=384></p>
+<p>There it is! You now have your first switching station.</p>
+<p><img src="switching_station.png" width=683 height=384></p>
+<p>"But", you will say, "what can I do with it now?". Well, to tell the truth: nothing. You need to produce energy in order to be able to do something with your brand new switching station. Therefore, we will craft two more components: the generator and the battery box. What those are used for is self-explainatory: the generator produces energy by burning up fuel, and the battery box can store or give energy to comply with the current energy demand and production.</p>
+<p>Firstly, the battery box: for that, you will only need a few batteries and <b>TODO</b>. The batteries aren't hard to craft either: you will just need some <b>TODO</b> and some <b>TODO</b>.</p>
+<p><img src="craft_battery.png" width=683 height=384> <img src="craft_battery_box.png" width=683 height=384></p>
+<p>Secondly, the generator: you will need <b>TODO</b></p>
+<p><img src="craft_generator.png" width=683 height=384></p>
+<p>Now, you can make a real circuit. Please note that the switching station needs to be above the wire, whereas the position of other machines relative to the wires has no effect at all.</p>
+<p><img src="basic_circuit.png" width=683 height=384></p>
+<p>To use the generator, simply put some fuel in its lower slot, and watch the battery box slowly fill up!</p>
+<p>"Ok, it's good, but what do we do now?". Well, we use that energy. Remember that machine I told yu about earlier? Well, we're going to build it. Get some desert stone, take a diamond - hey, if it was cheap, it would not be so powerful! - and craft a grinder.</p>
+<p><img src="craft_grinder.png" width=683 height=384></p>
+<p>Now you can connect the grinder to your electric network, and watch it slowly grind one lump into two dusts, which can each be smelted into an ingot. The grinder has a few other uses too: it can for example grind cobble into sand - ever thought glass was too expensive? It is no longer true! -, or <b>TODO</b> into <b>TODO</b></p>
+<h1>The basic machines</h1>
+<p></p>
+</body></html>
diff --git a/technic_tutorial.txt b/technic_tutorial.txt
new file mode 100644
index 0000000..5279c29
--- /dev/null
+++ b/technic_tutorial.txt
@@ -0,0 +1,161 @@
+Starting a new game
+===================
+
+Create a new world, and enable the following mods/modpacks (before
+entering that world for the first time):
+- mesecons
+- moreblocks (optional, but needed if you want to use "extranodes")
+- moreores
+- moretrees
+- pipeworks
+- plantlife (or at least, plants_lib)
+- technic
+- unified_inventory
+
+
+First steps
+===========
+
+[[worldcreate.png]]
+
+So, you've just spawned in a wonderful world, and you're probably
+wondering about what to do. Do as you would do on any map: dig a few
+trees (don't trash the leaves, they will be useful later), gather some
+cobble, craft a basic stone pick, and build your house... There are a
+few points you need to be careful about though: make your house big
+enough, and easy to extend, since the industry will need a lot of
+room, and, more importantly, if you decide to mine immediately, do not
+smelt any of your ore yet, except three iron lumps to craft an iron
+pick.
+
+[[house.png]]
+
+
+Time to mine!
+=============
+
+Now, gather your torches and pickaxes, and let's go down!
+
+[[ores1.png]]
+
+Here you can see from left to right:
+- Mese crystals
+- Tin
+- Iron
+- Copper (this is the metal you will most lack - not because it's
+rare, but because it is the most used one)
+- Zinc
+
+[[ores2.png]]
+
+From left to right:
+- Iron again
+- Coal (don't say it is useless, you will need it...)
+- Chromium (generates below -100)
+- Gold
+
+Other ores I haven't shown:
+- Uranium, a blue-green ore, only generates between -80 and -300
+- Mithril, a deep blue ore, generates below -512
+- Silver, a grey ore
+- Diamond, but you already know it...
+
+So, now you know all the ores, gather:
+<...>
+
+Don't forget that you should not smelt that ore! We will soon see a
+machine that will be able to produce two ingots for every lump you
+mine - so if you're too hasty, you will lose metal... 
+
+Your first electric network
+===========================
+
+Ok, now you can smelt some of your ore... But don't smelt all of it!
+Here is what you will need:
+<...>
+
+The base ingredient of electrical circuits is... wires, of course!
+So, craft <...> wires using the copper ingots.
+
+[[craft_lv_wire.png]]
+
+To run your circuit, you will also need a switching station - it is
+the component which will handle all the logic. However, building a
+switching station is expensive: You will need two wires, two copper
+ingots, four cast iron ingots and a LV transformer. I'm hearing you
+saying "Cast iron? What's that?", so let me explain a bit.
+
+[[craft_switching_station.png]]
+
+In technic, iron has several forms: the first one is wrought iron,
+which is basically iron, in its ingot form. The second one is cast
+iron, which is an alloy of iron and carbon, which high carbon
+content. To get it, just smelt again an ingot of wrought iron; the
+carbon in the coal will alloy with the iron and form cast iron. There
+are two other forms of iron, which we will see later.
+
+[[smelt_cast_iron.png]]
+
+Ok, so now you have to make a LV transformer to build that switching
+station. But do you know how a transformer is made? It is basically
+two coils around an iron core. Therefore, you will need seven wrought
+iron ingots and two coils to make it.
+
+[[craft_lv_transformer.png]]
+
+Finally, the copper coil. Well, it is but fine wire wrapped
+<... find better word> around some metal ring. To make it you need
+fine copper wire and <...> iron.
+
+[[craft_coil.png]]
+[[craft_fine_copper_wire.png]]
+
+There it is! You now have your first switching station.
+
+[[switching_station.png]]
+
+"But", you will say, "what can I do with it now?". Well, to tell the
+truth: nothing. You need to produce energy in order to be able to do
+something with your brand new switching station. Therefore, we will
+craft two more components: the generator and the battery box. What
+those are used for is self-explainatory: the generator produces energy
+by burning up fuel, and the battery box can store or give energy to
+comply with the current energy demand and production.
+
+Firstly, the battery box: for that, you will only need a few batteries
+and <...>. The batteries aren't hard to craft either: you will just
+need some <...> and some <...>.
+
+[[craft_battery.png]]
+[[craft_battery_box.png]]
+
+Secondly, the generator: you will need <...>
+
+[[craft_generator.png]]
+
+Now, you can make a real circuit. Please note that the switching
+station needs to be above the wire, whereas the position of other
+machines relative to the wires has no effect at all.
+
+[[basic_circuit.png]]
+
+To use the generator, simply put some fuel in its lower slot, and
+watch the battery box slowly fill up!
+
+"Ok, it's good, but what do we do now?". Well, we use that
+energy. Remember that machine I told yu about earlier? Well, we're
+going to build it. Get some desert stone, take a diamond - hey, if it
+was cheap, it would not be so powerful! - and craft a grinder.
+
+[[craft_grinder.png]]
+
+Now you can connect the grinder to your electric network, and watch it
+slowly grind one lump into two dusts, which can each be smelted into
+an ingot. The grinder has a few other uses too: it can also grind coal
+(you will need coal dust for several things), grind <...> into <...>,
+or grind cobble into sand - ever thought glass was too expensive? It
+is no longer true!
+
+The basic machines
+==================
+
