Index, readme stub, what is DF

README.md

@@ -1,2 +1,10 @@
-# DF-Walkthrough
-A step-by-step guide to play along with, until you're confident enough to go it alone.
+## PeridexisErrant's DF Walkthrough
+
+Resources for people who want to play Dwarf Fortress, but can't yet.
+
+* A simple step-by-step walkthrough to play along with.
+* Tutorials on specific topics for new players.
+* Lots of external links and advice.
+
+*This document is just a stub, to ensure something shows up on GitHub.*
+[*Check out the real index.*](./index.rst)

index.rst

@@ -0,0 +1,79 @@
+################################
+PeridexisErrant's DF Walkthrough
+################################
+
+The learning curve for Dwarf Fortress has been described as a spiked
+overhang - but many of us have fought our way up, and have more fun
+than any other game around.  This walkthrough, along with the
+:forums:`DF Starter Pack <126076>`, are my attempts to dangle a rope
+down, as the community first did for me years ago.
+
+
+The Walkthrough
+===============
+Dwarf Fortress is a rare game:  every time you start a new game, an
+entire world is created anew - everything from geology and weather,
+to the patterns of trade in wheat and wars between jealous kings.
+The fact that there is no script, no standard storyline that every
+player goes through, makes a traditional game walkthrough impossible.
+
+Instead this is more like a tutorial campaign in a strategy game -
+right down to playing on the same map, if you download the suggested
+package.  You're free to follow along exactly, but also encouraged to
+experiment (and maybe back up your save occasionally).
+
+Remember as you play that no matter how skilled you become, without a
+winning condition your fortress will inevitably fail - then pick yourself
+up,  reflect on what you learnt, and recite the motto:  **Losing is Fun!**
+
+
+.. toctree::
+   :numbered:
+   :maxdepth: 1
+   :glob:
+   
+   chapters/*
+
+
+Tutorials
+=========
+The walkthrough covers the topics you'll need in every fortress, in just
+enough detail to get you started.  After that, it's your decision what
+to focus on - the options are endless, from beekeeping to soap-making to
+digging too deep, or learning how to install or make mods for the game.
+
+Each tutorial is a short, self-contained introduction to a topic which is
+likely to be of interest to players who have just finished the walkthrough.
+And if you're most interested in somthing not listed here,
+`dwarffortresswiki <http://dwarffortresswiki.org>`_
+and the Bay12 Forums will be your best friends.
+
+
+.. toctree::
+   :maxdepth: 1
+   :glob:
+   
+   tutorials/*
+
+
+Other Information
+=================
+
+.. toctree::
+   :maxdepth: 1
+   :glob:
+
+   misc/*
+   *
+
+
+About
+=====
+This is a sucessor project to `TinyPirate's tutorials
+<http://afteractionreporter.com/dwarf-fortress-tutorials/>`_,
+with :reddit:`his approval <368j7h>`.
+
+It **does not** use vanilla Dwarf Fortress - DF as distributed by ToadyOne
+(the developer) - but embraces community mods, tools, and interface upgrades.
+If that's not your thing, try the guide :wiki:`on the wiki. <Quickstart_guide>`
+

misc/what-is-df.rst

@@ -0,0 +1,78 @@
+#######################
+What is Dwarf Fortress?
+#######################
+
+Above anything else, Dwarf Fortress is a complicated game.
+
+Enough has been written about this already, so this will simply link to
+some of the better articles for a background understanding.
+
+.. note to editors
+
+    These quotes are suggested reading for people who have never heard
+    of DF before.  Stick to official sources and the general media.
+
+
+.. epigraph::
+
+    Dwarf Fortress is a single-player fantasy game. You can control a
+    dwarven outpost or an adventurer in a randomly generated, persistent world.
+
+    Although Dwarf Fortress is still in a work in progress, many features
+    have already been implemented...
+
+    -- `Tarn Adams (developer of *Dwarf Fortress*) <http://bay12games.com/dwarves/features.html>`_
+
+
+.. epigraph::
+
+    "Losing is Fun"
+
+    -- Community motto
+
+
+.. epigraph::
+
+    Dwarf Fortress is a mixture of classic turn-based fantasy adventure
+    games and sophisticated city building that has been confounding
+    observers since 2006. It's visuals appear incomprehensible and
+    its learning curve not just steep and unending, but slippery and
+    sometimes electrified.
+
+    To look at Dwarf Fortress it is easy to imagine it as an
+    anachronistic throwback to the likes of Rogue and Nethack, a cute
+    little sort of retro tribute. However the truth of the matter,
+    which becomes rapidly more apparent as you learn exactly what is
+    being done within the game, is that this is not a primitive or old
+    fashioned game. Dwarf Fortress is spectacularly sophisticated. The
+    world that the game generates for you is created in the sort of
+    meticulous detail that would typically demand several hundred pages
+    of appendices at the end of a JRR Tolkien novel. Each created world
+    has a history, legendary figures, towns, cities and people. You can
+    create a world that is artificially aged up to a thousand years, or
+    you can start with a younger world, either approach bringing with it
+    different challenges. A new world might be untamed when a more
+    established one might be home to established communities of potential
+    foes such as goblins.
+
+    -- `NewStatesman  <http://www.newstatesman.com/killing-time/2014/07/way-down-hole-getting-grips-dwarf-fortress>`_
+
+
+.. epigraph::
+
+    Players are responsible for the cultivation and management of a 
+    virtual ecosystem — a colony of dwarves trying to build a thriving
+    fortress in a randomly generated world. Dwarf Fortress unfolds as
+    a series of staggeringly elaborate challenges and devastating
+    setbacks that lead, no matter how well one plays, to eventual ruin.
+
+    Many simulation games offer players a bag of building blocks, but
+    few dangle a bag as deep, or blocks as small and intricately
+    interlocking, as Dwarf Fortress. Beneath the game’s rudimentary
+    facade is a dizzying array of moving parts, algorithms that model
+    everything from dwarves’ personalities (some are depressive; many
+    appreciate art) to the climate and economic patterns of the
+    simulated world. ... 
+    
+    -- `The NY Times Magazine <http://www.nytimes.com/2011/07/24/magazine/the-brilliance-of-dwarf-fortress.html?_r=2&pagewanted=all>`_
+