Apply custom key style, index warning, fix link

chapters/chap01-setup-starting.rst

@@ -34,7 +34,7 @@ Now we’re ready to get going! Run the dwarfort.exe shortcut and you should get
 .. image:: images/dftutorial00.png
    :align: center
 
-So, you’ve got the game running and enjoyed the exciting ASCII intro movie. Well done! I can tell you’ll go far! Next step is to hit “enter” on “Continue Playing”, which should be highlighted. You’ll then be presented with this screen.
+So, you’ve got the game running and enjoyed the exciting ASCII intro movie. Well done! I can tell you’ll go far! Next step is to hit :kbd:`Enter` on :guilabel:`Continue Playing`, which should be highlighted. You’ll then be presented with this screen.
 
 .. image: images/dftutorial01.png
    :align: center
@@ -43,12 +43,12 @@ This is the save game list, which gets cluttered very quickly as seasonal saves
 
 First Look
 ==========
-Once the game loads you will be presented with this screen. Although it’s confusing on first glance, don’t panic! It will all be made clear shortly. First thing though, hit “space” to pause the game. Space pauses DF and also backs out of any menu you’re currently in.
+Once the game loads you will be presented with this screen. Although it’s confusing on first glance, don’t panic! It will all be made clear shortly. First thing though, hit :kbd:`Space` to pause the game. :kbd:`Space` pauses DF and also backs out of any menu you’re currently in.
 
 .. image:: images/dftutorial02.png
    :align: center
 
-Lets talk about what you can see. First up, the screen is divided into three sections: The left shows the local view. The center shows the action menu, the right shows the area map. To make things a lot neater hit “tab”. “Tab” cycles through various menu arrangements. Stop when your view matches the one below.
+Lets talk about what you can see. First up, the screen is divided into three sections: The left shows the local view. The center shows the action menu, the right shows the area map. To make things a lot neater hit :kbd:`Tab`, which cycles through various menu arrangements. Stop when your view matches the one below.
 
 .. image:: images/dftutorial03.png
    :align: center
@@ -65,12 +65,12 @@ Key to understanding DF’s local view is getting your head around the fact that
 .. image:: images/dftutorial05.png
    :align: center
 
-If you look on the bottom right of the window you’ll see we’re currently at level 144. To move between levels you need to hit “Shift+<” to go up, and “Shift+>” to go down. If you go up a level the map will look like image below. Try it yourself now. If you can’t get this to work, scroll down and read the comments. There’s a helpful poster there who has some tips for odd keyboard layouts.
+If you look on the bottom right of the window you’ll see we’re currently at level 144. To move between levels you need to hit :kbd:`<` to go up, and :kbd:`>` to go down. If you go up a level the map will look like image below. Try it yourself now. If you can’t get this to work, scroll down and read the comments. There’s a helpful poster there who has some tips for odd keyboard layouts.
 
 .. image:: images/dftutorial06.png
    :align: center
 
-You’ll see that what was black dirt is now grass and trees. It’s like we’ve gone up a floor in a lift and we’re no longer looking at a slope, now we’re looking across a grassy plain. Below us is open space and tree tops. Make sense? Now, try going back down to 144 and then down to 143, a level below “ground” level.
+You’ll see that what was black dirt is now grass and trees. It’s like we’ve gone up a floor in a lift and we’re no longer looking at a slope, now we’re looking across a grassy plain. Below us is open space and tree tops. Make sense? Now, try going back down to 144 and then down to 143, a level below "ground" level.
 
 .. image:: images/dftutorial07.png
    :align: center
@@ -88,24 +88,24 @@ So now what do we do? In Dwarf Fortress we’re usually trying to get a bustling
 
 If you go down and a little across from where our dwarfs are (using the arrow keys) you’ll see a nice cliff face. Lets dig an entrance into this spot and plan to eventually dig down way underground where it’s safe and cosy. First up, get the map centered around about where we want to dig (shown on the screenshot below). Once you’re ready:
 
-* Hit the “d” key. You’ll see the menu on the right changes and in the local view a yellow X has appeared. The menu on the right should show the “mine” option highlighted. If it doesn’t, hit “d” “again, to select it.
+* Hit the :kbd:`d` key. You’ll see the menu on the right changes and in the local view a yellow X has appeared. The menu on the right should show the "mine" option highlighted. If it doesn’t, hit :kbd:`d` again, to select it.
 * Move the cursor to the edge of the cliff, like this:
 
 .. image:: images/dftutorial09.png
    :align: center
 
-* Now hit enter and move your cursor down with the arrow keys. You’ll see that you’ve dropped a flashing “anchor”. This is going to mark out what your dwarfs will dig. Move it down 20 and across 3 and hit enter, your screen should look like this:
+* Now hit enter and move your cursor down with the arrow keys. You’ll see that you’ve dropped a flashing "anchor". This is going to mark out what your dwarfs will dig. Move it down 20 and across 3 and hit enter, your screen should look like this:
 
 .. image:: images/dftutorial10.png
    :align: center
 
-The browned out area shows where your miners are going to come along and dig. But they won’t act until you back out of the “designations” menu as the game is paused. Hit “space” and you should see the game unpause and the menu reset to its master list. Oh, when you have the “d” menu up you can actually click on the map with your mouse and select areas to mine. Some people prefer to select areas this way.
+The browned out area shows where your miners are going to come along and dig. But they won’t act until you back out of the :guilabel:`designations` menu as the game is paused. Hit :kbd:`Space` and you should see the game unpause and the menu reset to its master list. Oh, when you have the :kbd:`d` menu up you can actually click on the map with your mouse and select areas to mine. Some people prefer to select areas this way.
 
 With the game unpaused you should notice three dwarfs race to the cliff face and start digging. With our entrance under way we should also think about laying out some rooms for our dwarfs to live in, who wants to spend time out under that hot yellow disk when lovely rock and earth beckon!
 
 Right now we’re not worried about making our fortress perfect and creating the strongest entrance, we’re simply trying to scratch out a space to live! To that end we’ll need three or four rooms off this main entrance.
 
-See if you can match the layout below by marking out areas to dig, as you’ve learnt. If you make a mistake you can hit “x” from the “designations” (“d”) menu and you’ll note that the menu on the right has “remove designation” highlighted. Now when you hit enter and select an area, any area set for digging will be cleared of that designation. Anyway, enough detail, on with the room building!
+See if you can match the layout below by marking out areas to dig, as you’ve learnt. If you make a mistake you can hit :kbd:`x` from the :guilabel:`designations` (:kbd:`d`) menu and you’ll note that the menu on the right has :guilabel:`remove designation` highlighted. Now when you hit enter and select an area, any area set for digging will be cleared of that designation. Anyway, enough detail, on with the room building!
 
 .. image:: images/dftutorial11.png
    :align: center
@@ -119,7 +119,7 @@ Dirt and rocks are handy, but so is wood to make nice dwarven beds, and we’re
 Designating trees to chop is like designating rocks to be dug, so lets decimate the local environment!
 
 * Move the map around so you’re looking out front of your fortress.
-* Hit “d”. Hopefully this time you’ll notice the game has automatically got “Chop down trees” selected, if it doesn’t, hit “t” and it will be highlighted.
+* Hit :kbd:`d`. Hopefully this time you’ll notice the game has automatically got :guilabel:`Chop down trees` selected, if it doesn’t, hit :kbd:`t` and it will be highlighted.
 * Move the cursor to the upper left, hit enter, and move the cursor to the bottom right, hit enter again. Any trees in that area will now be set to be cut, as indicated by them all being marked brown.
 
 Your view now should look something like this, note all the trees highlighted in brown:
@@ -129,7 +129,7 @@ Your view now should look something like this, note all the trees highlighted in
 
 Although you’ve done well neither man nor dwarf can live on wood and dirt alone! Luckily for us there are plenty of bushes out there loaded with ripe berries. Lets set some of them to be picked:
 
-* Hit “d” again and then “p”. One the right “Gather plants” is now selected.
+* Hit :kbd:`d` again and then :kbd:`p`. One the right :guilabel:`Gather plants` is now selected.
 * Designate about the same area as we did with the wood cutting.
 * All the bushes will be highlighted now, and when you unpause you should see a plant harvesting dwarf join the woodcutter.
 
@@ -140,38 +140,38 @@ Our First Farm
 Farming is how you will make most of your food in Dwarf Fortress, and it’s important to get farming quite quickly. If food runs out your dwarfs will starve and your game will end prematurely, and we don’t want that, right? Dwarfs usually farm underground and handily, we have a space all prepared. So follow along, and lets get some tasty mushrooms growing for our stumpys to chow down on!
 
 * Find the bottom right room.
-* Hit “b” for the build menu and then “p” for farm plot.
+* Hit :kbd:`b` for the build menu and then :kbd:`p` for farm plot.
 * Move the cursor to your farm area.
-* The screen instructions tell you how you can increase the size, we need a good 6 by 6 plot, so hit “u” and “k” a few times until you’ve got a big green grid, like the one below.
-* Move the grid around with the arrow keys until it’s in about the same position as the one in the screenshot. If you get the size wrong, “h” and “m” will reduce the plot.
+* The screen instructions tell you how you can increase the size, we need a good 6 by 6 plot, so hit :kbd:`u` and :kbd:`k` a few times until you’ve got a big green grid, like the one below.
+* Move the grid around with the arrow keys until it’s in about the same position as the one in the screenshot. If you get the size wrong, :kbd:`h` and :kbd:`m` will reduce the plot.
 
 .. image:: images/dftutorial13.png
    :align: center
 
-* Hit “enter” and the green area marker will change to a flashing brown field marker. When stuff flashes it indicates that dwarfs are on their way to come build the construction, in this case, a field. And lookee-here! A farmer has come to build our field for us!
+* Hit :kbd:`Enter` and the green area marker will change to a flashing brown field marker. When stuff flashes it indicates that dwarfs are on their way to come build the construction, in this case, a field. And lookee-here! A farmer has come to build our field for us!
 
 .. image:: images/dftutorial14.png
    :align: center
 
 He will take a short while to build your field. When you see the dwarf run off, you know he’s done. Now it’s time to set the field to grow delicious plump helms all year round.
 
-* Hit the “q” key. This is the key for “Set building tasks and preferences”. Again you’ll notice a cursor on the local screen and if it’s anywhere near the field, the field will be flashing. You can move that cursor around with your arrow keys, this is useful later on when you need to select different workshops and buildings.
+* Hit the :kbd:`q` key. This is the key for :guilabel:`Set building tasks and preferences`. Again you’ll notice a cursor on the local screen and if it’s anywhere near the field, the field will be flashing. You can move that cursor around with your arrow keys, this is useful later on when you need to select different workshops and buildings.
 * You’ll note that on the right the menu now shows you specific task details associated with that field, like so:
 
 .. image:: images/dftutorial15.png
    :align: center
 
-* What we want to do is set “plump helmets” as the food to be planted every season. You can see on the top right of the menu we have the various plants we could try and grow and in the middle area we have the different seasons. Right now “Dimple cups” are selected (but not highlighted, note) and the season is set on “Spring”, as it’s Spring currently. We need to change these settings.
-* Now comes an important skill! Menu scrolling! Using “alt+arrow down”, scroll down through the list to “Plump helmets” and hit enter.  You should now see “Plump helmets” highlighted. By the way, if you don’t like this key configuration, hit escape when we’re done and re-bind the keys to your liking.
-* Good work! But right now we’ve only set the spring planting. It’s time to set the planting for Summer, Winter and Autumn too. To do this, with the field task menu up, hit “b” for Summer and then scroll to “Plump helmets” and hit enter again. Hit “c” for Autumn, set “Plump helmets” and then “d” for Winter, repeating your selection. You may have noticed that what you can plant changes with the seasons, but don’t worry about that for now.
-* Hit “space” to back out of the menu and resume the game. Your two farmer dwarfs will quickly begin planting in your new field, well done!
+* What we want to do is set :guilabel:`Plump helmets` as the food to be planted every season. You can see on the top right of the menu we have the various plants we could try and grow and in the middle area we have the different seasons. Right now :guilabel:`Dimple cups` are selected (but not highlighted, note) and the season is set on :guilabel:`Spring`, as it’s Spring currently. We need to change these settings.
+* Now comes an important skill! Menu scrolling! Using :kbd:`Alt`-:kbd`↓`, scroll down through the list to :guilabel:`Plump helmets` and hit enter.  You should now see :guilabel:`Plump helmets` highlighted. By the way, if you don’t like this key configuration, hit :kbd:`Esc` when we’re done and re-bind the keys to your liking.
+* Good work! But right now we’ve only set the spring planting. It’s time to set the planting for Summer, Winter and Autumn too. To do this, with the field task menu up, hit :kbd:`b` for Summer and then scroll to :guilabel:`Plump helmets` and hit enter again. Hit :kbd:`c` for Autumn, set :guilabel:`Plump helmets` and then :kbd:`d` for Winter, repeating your selection. You may have noticed that what you can plant changes with the seasons, but don’t worry about that for now.
+* Hit :kbd:`Space` to back out of the menu and resume the game. Your two farmer dwarfs will quickly begin planting in your new field, well done!
 
 Now we’ve got a field down hopefully none of your dwarfs will starve, go crazy and resort to eating rats, or each other. Pretty soon you’ll have a few seeds in the ground and your farm will begin to look a bit like this:
 
 .. image:: images/dftutorial16.png
    :align: center
 
-Oh, by now you may have noticed the game pausing itself now and then. This is generally because the game wants to let you know that something important has happened. You can hit space to let the game resume, or hit “a” to see the alert and find out what caused the game to pause (if you miss the alert at the bottom of the screen). Hitting “space” will take you back out of the alerts menu and resume the game.
+Oh, by now you may have noticed the game pausing itself now and then. This is generally because the game wants to let you know that something important has happened. You can hit space to let the game resume, or hit :kbd:`a` to see the alert and find out what caused the game to pause (if you miss the alert at the bottom of the screen). Hitting :kbd:`Space` will take you back out of the alerts menu and resume the game.
 
 Stockpiles
 ==========
@@ -180,8 +180,8 @@ While you can just leave all of your dwarfs’ stuff strewn around the countrysi
 This is where stockpiles come in. They make everything more organised. A stockpile for all our food and seeds right next door to the farm would probably be pretty handy, right? We don’t want the dwarfs running across the map to get a bite to eat or a seed to plant, so lets make a food stockpile inside!
 
 * Find the room opposite the farm.
-* Hit the “p” key (for “piles” of course), a cursor will appear.
-* Hit “f” to select “food”, we want to make a food stockpile, after all.
+* Hit the :kbd:`p` key (for "piles" of course), a cursor will appear.
+* Hit :kbd:`f` to select :guilabel:`Food`, we want to make a food stockpile, after all.
 * Move the cursor to the bottom left of the room, hit enter, move it to the top right and hit enter again. You have now set that entire space as a food stockpile, well done!
 * After a few seconds your spare dwarfs will start moving food inside, you’ll see barrels and bags being hauled and pretty soon the stockpile will look something like this: