Style chap02

chapters/chap02-workshops-digging.rst

@@ -6,34 +6,34 @@ Lets continue on with our exciting and fascinating Dwarf Fortress Walkthrough! I
 
 Building a Workshop
 ===================
-Workshops are a central feature of DF so lets get to grips with them right away. Workshops are places your dwarfs work, usually turning base materials into useful goods. The list of workshops can be a little overwhelming (“b” then “w”), but don’t worry, we only need to worry about a couple early on.
+Workshops are a central feature of DF so lets get to grips with them right away. Workshops are places your dwarfs work, usually turning base materials into useful goods. The list of workshops can be a little overwhelming (:kbd:`b` then :kbd:`w`), but don’t worry, we only need to worry about a couple early on.
 
 First up we need a carpenter’s workshop, this workshop allows us to turn wood logs into furniture and other items. You should see a lot of wood scattered around in front of the fort, where the wood cutter has left it after felling trees. We have no wood pile for it to be moved to, you see.
 
 Ideally, we’d like to build the carpenter’s workshop inside, but we haven’t dug a nice enough space for the workshop yet, so lets chuck it outside for now:
 
 * Move the view to the front of the fortress.
-* Hit “b” for “build”, and then “w” for “workshop”. You can also just scroll down to “Workshops” using “alt+down arrow” and hit enter.
+* Hit :kbd:`b` for :guilabel:`build`, and then :kbd:`w` for :guilabel:`workshop`. You can also just scroll down to :guilabel:`Workshops` using :kbd:`Alt`-:kbd:`↓` and hit :kbd:`Enter`.
-* You will now see a list of workshops. It scrolls off the bottom of the page (scroll around if you like)! Hit “c” for “Carpenter’s workshop”.
+* You will now see a list of workshops. It scrolls off the bottom of the page (scroll around if you like)! Hit :kbd:`c` for :guilabel:`Carpenter’s workshop`.
 * The menu will vanish and the placement menu will appear. The green X’s mark out the workshop’s footprint. The dark green Xs are squares that will be impassible once the workshop is built, keep this in mind when building in an enclosed space, you don’t want to block the door!
 
 .. image:: images/dftutorial18.png
    :align: center
 
-* Chose a spot in front of the fortress. Somewhere round where mine is marked should do. Once you’re ready to place your workshop hit “enter”.
+* Chose a spot in front of the fortress. Somewhere round where mine is marked should do. Once you’re ready to place your workshop hit :kbd:`Enter`.
 * The menu on the right will now change to a list of items you could use to build the workshop with. Mostly it will be a list of wood and it will look something like this:
 
 .. image:: images/dftutorial19.png
    :align: center
 
-* At this point you could just hit enter and the first item on the list will be used to build the workshop. Instead, for fun, hit “x” and “expand” the view to show a list of every single item the workshop can be built from. Expanding the item selection is a nice way to chose exactly the item you want to be used. Most of the time you can ignore this option, but it will come in handy later on.
+* At this point you could just hit enter and the first item on the list will be used to build the workshop. Instead, for fun, hit :kbd:`x` and "expand" the view to show a list of every single item the workshop can be built from. Expanding the item selection is a nice way to chose exactly the item you want to be used. Most of the time you can ignore this option, but it will come in handy later on.
-* Close the expanded menu with “x” again. For your interest note that items are sorted by distance from the workshop’s current location. Usually you want to build with the closest items to save your dwarfs a slow walk.
+* Close the expanded menu with :kbd:`x` again. For your interest note that items are sorted by distance from the workshop’s current location. Usually you want to build with the closest items to save your dwarfs a slow walk.
 * Once you’ve hit enter (selecting the building material) the workshop will be placed in an un-built state on the map. It will look like this:
 
 .. image:: images/dftutorial20.png
    :align: center
 
-Your workshop is now about to be built. You will have to hit space a couple of times to un-pause the game, but as soon as you do I bet you that a helpful wee dwarf will run over and start building it. If you’re quick you can hit “q” and see the status of the workshop, it should say “Construction initiated” or something similar.
+Your workshop is now about to be built. You will have to hit space a couple of times to un-pause the game, but as soon as you do I bet you that a helpful wee dwarf will run over and start building it. If you’re quick you can hit :kbd:`q` and see the status of the workshop, it should say :guilabel:`Construction initiated` or something similar.
 
 A few seconds later, the workshop is built!
 
@@ -48,25 +48,25 @@ Dwarfs don’t like sleeping in the dirt, they like nice, comfy beds - and solid
 
 Follow along with me:
 
-* Hit “q” and move the cursor over the carpentry workshop.
+* Hit :kbd:`q` and move the cursor over the carpentry workshop.
-* The menu on the right now shows you the actions you can take, specifically, we’re interested in “a: Add new task”.
+* The menu on the right now shows you the actions you can take, specifically, we’re interested in :kbd:`a` :guilabel:`Add new task`.
-* Hit “a” (duh)!
+* Hit :kbd:`a` (duh)!
 * Note the right menu is now a large list of stuff we can make. We’re after beds.
-* You can scroll down to beds using “alt+down arrow”, or simply hit “b”.
+* You can scroll down to beds using :kbd:`↓`, or simply hit :kbd:`b`.
-* The menu now changes back to the “q” list and you’ll see “Construct bed” listed. But we want more than one bed!
+* The menu now changes back to the :kbd:`q` list and you’ll see :guilabel:`Construct bed` listed. But we want more than one bed!
-* Hit “a” again, and then “b”. Repeat until we’ve got five beds up there. We don’t need a bed for every dwarf just yet, luckily for us they seem happy to sleep in shifts.
+* Hit :kbd:`a` again, and then :kbd:`b`. Repeat until we’ve got five beds up there. We don’t need a bed for every dwarf just yet, luckily for us they seem happy to sleep in shifts.
 
 Your carpentry workshop menu should now look like this:
 
 .. image:: images/dftutorial22.png
    :align: center
 
-If your workshop menu looks like this, well done! Five beds are queued up and hitting space a couple of times will un-pause the game and set a dwarf working, building your beds. You may have noted that there are a lot of other workshop options available to us now we have items on the build list. We can “s” suspend any construction, set any item to be “r”, repeat built, or we can hit “c” and cancel the construction of the current listed item. We can also fiddle with the workshop profile by using shift+p, “P”, or have the entire workshop removed using “x”. For now, lets just watch the beds get built!
+If your workshop menu looks like this, well done! Five beds are queued up and hitting space a couple of times will un-pause the game and set a dwarf working, building your beds. You may have noted that there are a lot of other workshop options available to us now we have items on the build list. We can :kbd:`s` suspend any construction, set any item to be :kbd:`r`, repeat built, or we can hit :kbd:`c` and cancel the construction of the current listed item. We can also fiddle with the workshop profile by using :kbd:`P`, or have the entire workshop removed using :kbd:`x`. For now, lets just watch the beds get built!
 
 Note, you won’t see the beds being put anywhere. Want to know why? The answer is simple, and if you’re extra-special clever you may have already worked it out: We have no furniture stockpile! Lets fix that:
 
-* Hit “p” from the main menu.
+* Hit :kbd:`p` from the main menu.
-* hit “u” for “Furniture stockpile”.
+* hit :kbd:`u` for :guilabel:`Furniture stockpile`.
 * Move the X near the workshop, hit enter, and designate a pile about 5 tiles by 5 tiles.
 
 Here’s my pile after a few seconds of the game resumed:
@@ -74,16 +74,16 @@ Here’s my pile after a few seconds of the game resumed:
 .. image:: images/dftutorial23.png
    :align: center
 
-You’ll note the dwarfs have moved the constructed beds to the pile as well as some spare barrels, our anvil and a bag. As stated above, we don’t usually like to leave our stuff lying around outside, even in tidy piles, but as a temporary solution it helps keep things organised and gets the furniture moved from the workshop. If items aren’t pulled out from under the carpenter’s feet then eventually the workshop will get cluttered (marked with “[CLT]” when you “q” over the workshop) and a cluttered workshop works slower.
+You’ll note the dwarfs have moved the constructed beds to the pile as well as some spare barrels, our anvil and a bag. As stated above, we don’t usually like to leave our stuff lying around outside, even in tidy piles, but as a temporary solution it helps keep things organised and gets the furniture moved from the workshop. If items aren’t pulled out from under the carpenter’s feet then eventually the workshop will get cluttered (marked with :guilabel:`[CLT]` when you :kbd:`q` over the workshop) and a cluttered workshop works slower.
 
-Later on we can remove piles by using “p” and then “x” and selecting the whole area of the stockpile. What’s better is that helpful dwarfs will grab those items and move them to another suitable pile. But enough of that, lets get on with building our fortress!
+Later on we can remove piles by using :kbd:`p` and then :kbd:`x` and selecting the whole area of the stockpile. What’s better is that helpful dwarfs will grab those items and move them to another suitable pile. But enough of that, lets get on with building our fortress!
 
 Digging down, down, down!
 =========================
-What kind of Dwarfs would we be if we only scratched around on the top of this mound like dirty hobbits? We want to dig down, down, down! The easiest way of doing this is to build some stairs. Well, to be precise, we’re going to designate some stairs using the “d” menu. We are going to designate some un-dug space to be stairs and then see what’s going on a few feet down. So follow along, and lets get expanding!
+What kind of Dwarfs would we be if we only scratched around on the top of this mound like dirty hobbits? We want to dig down, down, down! The easiest way of doing this is to build some stairs. Well, to be precise, we’re going to designate some stairs using the :kbd:`d` menu. We are going to designate some un-dug space to be stairs and then see what’s going on a few feet down. So follow along, and lets get expanding!
 
 * Move the map to the bottom end of our corridor.
-* Hit “d” and then “j” for “downward stairway”.
+* Hit :kbd:`d` and then :kbd:`j` for :guilabel:`downward stairway`.
 * Move the X into the black and hit enter, move the cursor down one, and hit enter again.
 
 You should see two downwards stairs marked, like this:
@@ -91,7 +91,7 @@ You should see two downwards stairs marked, like this:
 .. image:: images/dftutorial24.png
    :align: center
 
-But what’s this? We have a problem! How will our miners get there to dig out our stairs? Best we designate an area around those stairs to be dug using “d” and “d” (“Mine”). Here’s how I set it up:
+But what’s this? We have a problem! How will our miners get there to dig out our stairs? Best we designate an area around those stairs to be dug using :kbd:`d` and :kbd:`d` (:guilabel:`Mine`). Here’s how I set it up:
 
 .. image:: images/dftutorial25.png
    :align: center
@@ -103,7 +103,7 @@ Hit space until the game is running and let that area get built. It should look
 .. image:: images/dftutorial26.png
    :align: center
 
-Super! A hallway and two downward staircases! At this point you may be feeling pretty chuffed with yourself. But if you go down a level (“shift+>”, you’ll recall) you’ll not see any stairs going up, or much of anything, just these tan blobs:
+Super! A hallway and two downward staircases! At this point you may be feeling pretty chuffed with yourself. But if you go down a level (:kbd:`>`, you’ll recall) you’ll not see any stairs going up, or much of anything, just these tan blobs:
 
 .. image:: images/dftutorial27.png
    :align: center
@@ -112,19 +112,19 @@ Where are our stairs going up? Where are our vast stores of mineral wealth? Well
 
 To dwarves a down stair is just an exploratory stair dug down to see what’s on the level below. It’s like knocking a hole in the floor so you can look down on your neighbours in the flat below, hoping perhaps to work out what the weird noises are.
 
-To actually go down to the level below, you need to build stairs going up from the level you’re digging to. Or in our case, we want to build an “Up/Down Stairway” as we are looking to dig down a long, long way. An Up/Down stairway pokes the proverbial holes in both directions. It links up with a stairway above (if there’s one there) and tries to link up with a stairway below (if there’s one there). If there’s no stairway to link up with it will provide access to those other levels so you can build the needed stairs. To build one, do this:
+To actually go down to the level below, you need to build stairs going up from the level you’re digging to. Or in our case, we want to build an :guilabel:`Up/Down Stairway` as we are looking to dig down a long, long way. An Up/Down stairway pokes the proverbial holes in both directions. It links up with a stairway above (if there’s one there) and tries to link up with a stairway below (if there’s one there). If there’s no stairway to link up with it will provide access to those other levels so you can build the needed stairs. To build one, do this:
 
 * Go down one level from our main area.
-* At this level, below our down stairs, hit “d” and then “i” for “Up/Down Stairway”.
+* At this level, below our down stairs, hit :kbd:`d` and then :kbd:`i` for :guilabel:`Up/Down Stairway`.
 * Move the X over the two tan blocks. Hit enter, move down one, hit enter again.
 * Two brown X’s now show that your up-down stairway has been designated.
-* If you mess it up, “d” and then “x” can un-designate the space for you.
+* If you mess it up, :kbd:`d` and then :kbd:`x` can un-designate the space for you.
 * Resume the game and the up/down stairs will be dug. Once dug, they will look like this:
 
 .. image:: images/dftutorial28.png
    :align: center
 
-Lovely! Two perfect up-down stairs. But we’re not done yet. **Go down a level and build two more up-down stairs.** Once you’ve done this, **drop a level again and designate two upward stairways using “d” and “u”.** You should end up seeing something like this once they are built. This is on level 142 141 (see top right for current level), or three levels down. If you don’t see stone, you’re on the wrong level!
+Lovely! Two perfect up-down stairs. But we’re not done yet. **Go down a level and build two more up-down stairs.** Once you’ve done this, drop a level again and designate two upward stairways using :kbd:`d` and :kbd:`u`. You should end up seeing something like this once they are built. This is on level 142 141 (see top right for current level), or three levels down. If you don’t see stone, you’re on the wrong level!
 
 .. image:: images/dftutorial29.png
    :align: center
@@ -140,16 +140,16 @@ Along the way you may get various messages about striking various ores. That’s
 
 What’s that on the ground?
 ==========================
-While they’re busy digging, why not have a look at what is scattered all over the ground. To do that, from the main menu, hit “k” for “Look Around”. An X will appear and you can direct it using the arrow keys. As you move it around you’ll see what’s under the arrow. Check my example:
+While they’re busy digging, why not have a look at what is scattered all over the ground. To do that, from the main menu, hit :kbd:`k` for :guilabel:`Look Around`. An X will appear and you can direct it using the arrow keys. As you move it around you’ll see what’s under the arrow. Check my example:
 
 .. image:: images/dftutorial31.png
    :align: center
 
-As you can see, underneath my X is a dwarf, some limestone, and a limestone cavern floor. I can use the alternate scroll (“alt+”down arrow”) to move through those three items, and hitting enter will display me some info about each. Ok, except for the floor. I mean, what do you want to know? It’s a floor!
+As you can see, underneath my X is a dwarf, some limestone, and a limestone cavern floor. I can use the alternate scroll :kbd:`↓` to move through those three items, and hitting enter will display me some info about each. Ok, except for the floor. I mean, what do you want to know? It’s a floor!
 
-“Look around” is a very handy way to see what is in a square. Sometimes items get stacked a few deep and you’re not sure what is what, “k” will show you. Also, it is very handy way to find out what the walls and ground are made of. For example, without irrigation you won’t be able to build a farm plot inside on anything but soil, sand, silt, clay or loam. “Look around” will show you what the ground is made of.
+:guilabel:`Look around` is a very handy way to see what is in a square. Sometimes items get stacked a few deep and you’re not sure what is what, :kbd:`k` will show you. Also, it is very handy way to find out what the walls and ground are made of. For example, without irrigation you won’t be able to build a farm plot inside on anything but soil, sand, silt, clay or loam. :guilabel:`Look around` will show you what the ground is made of.
 
-Toy with “k” for a while, see if you can find the bauxite. We’re lucky, bauxite is a very handy material to make magma-proof mechanisms and floodgates out of. Lets leave the dwarfs digging, we’ve got a very important job to do…
+Toy with :kbd:`k` for a while, see if you can find the bauxite. We’re lucky, bauxite is a very handy material to make magma-proof mechanisms and floodgates out of. Lets leave the dwarfs digging, we’ve got a very important job to do…
 
 Chucking out the trash!
 =======================
@@ -158,16 +158,16 @@ By now, believe it or not, some rubbish may be building up in your fortress. I
 .. image:: images/dftutorial32.png
    :align: center
 
-Using “k” I can have a closer look and see exactly what this trash is:
+Using :kbd:`k` I can have a closer look and see exactly what this trash is:
 
 .. image:: images/dftutorial33.png
    :align: center
 
 Yuck! This is the remains of some food turtles we brought with us on our journey. We can’t have this left lying around our tidy fortress, can we? Well, we could, but the end result would be a stinking cloud of purple miasma. Miasma makes our dwarfs unhappy. While they may never shower and probably reek to high-heaven, they really don’t like the smell of rotting leftovers. Go figure.
 
-So how do we get rid of the refuse? Easy! We build a “p” “stockpile for “r” “refuse”. But note, we need to build this pile outside or we’ll get miasma build-up. Outside, the wind blows the stink away.
+So how do we get rid of the refuse? Easy! We build a :kbd:`p` :guilabel:`stockpile` for :kbd:`r` :guilabel:`refuse`. But note, we need to build this pile outside or we’ll get miasma build-up. Outside, the wind blows the stink away.
 
-See if you can set up a refuse pile on your own like mine. It’s just like making any other pile, except we set “r” for refuse as we plot it.
+See if you can set up a refuse pile on your own like mine. It’s just like making any other pile, except we set :kbd:`r` for refuse as we plot it.
 
 .. image:: images/dftutorial34.png
    :align: center
@@ -186,9 +186,9 @@ So what do we do about the dwarf booze demands? Simple! We build a still!
 
 Follow along, dear reader:
 
-* Hit “b” for “Build”.
+* Hit :kbd:`b` for :guilabel:`Build`.
-* Hit “w” for “Workshops”.
+* Hit :kbd:`w` for :guilabel:`Workshops`.
-* Hit “l” for “Still”, or scroll through and find the still yourself, and hit enter.
+* Hit :kbd:`l` for :guilabel:`Still`, or scroll through and find the still yourself, and hit enter.
 * Place the still in the room next to the food stockpile, like this.
 
 .. image:: images/dftutorial35.png
@@ -201,22 +201,22 @@ Placing it near food makes sense, as it will turn food items into booze. The les
 
 Now to make it start churning out the brewskies!
 
-* Hit “q” and move the cursor to the still.
+* Hit :kbd:`q` and move the cursor to the still.
-* Hit “a” for “add task”.
+* Hit :kbd:`a` for :guilabel:`add task`.
-* Hit “b” for “Brew a Drink”
+* Hit :kbd:`b` for :guilabel:`Brew a Drink`
-* Hit “a” and “b” another 7 or so times.
+* Hit :kbd:`a` and :kbd:`b` another 7 or so times.
 
 Yay! You have now queued up a lot of beer to be made. But you’re going to need to do something else to keep the booze flowing; you’re going to need to make barrels.
 
 * Head to the carpenter.
-* Hit “q”.
+* Hit :kbd:`q`.
-* Hit “a”.
+* Hit :kbd:`a`.
-* Scroll down to “Make wooden Barrel”, or just hit “v”.
+* Scroll down to :guilabel:`Make wooden Barrel`, or just hit :kbd:`v`.
 * Fill the queue with barrels.
 
-That should see your dwarfs produce enough booze to keep them going for a while. Repeat that process a few times or put “Brew Drink” and “Make Barrels” on repeat for five minutes. End result, happy drunk dwarfs! An important thing to note at this point is that brewing alcohol uses plants, but doesn’t destroy the seeds. Cooking does destroy the seeds of any plant cooked, which can seriously compromise your ability to grow more food! So for now, lets just stick to making some extra booze. We should be ok for food for a while yet with our farm running.
+That should see your dwarfs produce enough booze to keep them going for a while. Repeat that process a few times or put :guilabel:`Brew Drink` and :guilabel:`Make Barrels` on repeat for five minutes. End result, happy drunk dwarfs! An important thing to note at this point is that brewing alcohol uses plants, but doesn’t destroy the seeds. Cooking does destroy the seeds of any plant cooked, which can seriously compromise your ability to grow more food! So for now, lets just stick to making some extra booze. We should be ok for food for a while yet with our farm running.
 
-Time to head back down stairs to see how our miners are going. Let them dig at least one room out before continuing with the next step. Hopefully they’re not sleeping on the job (The big “Z” flashing on them)!
+Time to head back down stairs to see how our miners are going. Let them dig at least one room out before continuing with the next step. Hopefully they’re not sleeping on the job (The big :guilabel:`Z` flashing on them)!
 
 The World of Doors!
 ===================
@@ -224,9 +224,9 @@ We need doors. Lots of doors. We need beds, doors, chairs, tables. We need lots
 
 Well, we could build some doors and assorted other stuff in our carpenters’ workshop. But that would use valuable wood. Much better would be to use all that stone you can see strewn about. So how do we do that? I’m glad you asked! We build a masons workshop. Here’s how:
 
-* Hit “b” for “Build”.
+* Hit :kbd:`b` for :guilabel:`Build`.
-* “w” for “Workshops”.
+* :kbd:`w` for :guilabel:`Workshops`.
-* “m” for “Mason’s Workshop”.
+* :kbd:`m` for :guilabel:`Mason’s Workshop`.
 
 Chose an area near our main stairs up, in one of our new rooms. You can check the shot below to see where I’m going to place mine.
 
@@ -237,14 +237,14 @@ Chose an area near our main stairs up, in one of our new rooms. You can check th
 
 Once it’s up it’s time to get it producing some useful items:
 
-* “q” over the Mason’s Workshop.
+* :kbd:`q` over the Mason’s Workshop.
-* “a” for “add task”, then “d” for door. Do this four times.
+* :kbd:`a` for :guilabel:`add task`, then :kbd:`d` for door. Do this four times.
-* “a” for add task, then “t” for table, do this twice.
+* :kbd:`a` for add task, then :kbd:`t` for table, do this twice.
-* “a for add task, then “c” for chair, do this twice.
+* :kbd:`a` for add task, then :kbd:`c` for chair, do this twice.
 
 Wee! Look at all that lovely furniture queued up! Soon our mason will turn up and start cutting blocks of stone into something more useful. Unfortunately, someone is going to end up trying to haul all that furniture up stairs to the furniture stockpile, and we can’t have that, so lets make a big stockpile in the middle of this room.
 
-While you’re at it, why not remove the furniture stockpile upstairs and get all of that stuff out of the rain. Go up to the pile, hit “p” for pile, then “x” and then hit enter at one corner of the outdoors furniture stockpile, and then move the cursor to the other end and hit enter again. Here’s my downstairs stockpile, complete with some just-moved furniture and some doors!
+While you’re at it, why not remove the furniture stockpile upstairs and get all of that stuff out of the rain. Go up to the pile, hit :kbd:`p` for pile, then :kbd:`x` and then hit enter at one corner of the outdoors furniture stockpile, and then move the cursor to the other end and hit enter again. Here’s my downstairs stockpile, complete with some just-moved furniture and some doors!
 
 .. image:: images/dftutorial38.png
    :align: center
@@ -256,14 +256,14 @@ Home Sweet Home
 You may have noticed that our dwarfs have been sleeping on the ground when they get tired. This is really not much fun for them and we’d like to give them a place to stay. With some beds built, lets set up a big bedroom on the top floor so our dwarfs can get some shuteye.
 
 * Head to the top floor, we’re going to build in the spare room.
-* Hit “b” and then “b” again (for “bed”).
+* Hit :kbd:`b` and then :kbd:`b` again (for :guilabel:`bed`).
 * Move the cursor and place a bed in the corner (hit enter, select a bed and hit enter again).
 * Spread the five bed around the room.
-* Hit “space” until we’re back at the main menu.
+* Hit :kbd:`Space` until we’re back at the main menu.
-* Hit “b” again, and “d” for “door”.
+* Hit :kbd:`b` again, and :kbd:`d` for :guilabel:`door`.
 * Place doors at each of the room entrances.
 
-Here’s my room layout. The shadowy beds and door show that the beds and doors aren’t placed yet. The green X shows me about to place the next door.
+Here’s my room layout. The shadowy beds and door show that the beds and doors aren’t placed yet. The green :guilabel:`X` shows me about to place the next door.
 
 .. image:: images/dftutorial39.png
    :align: center
@@ -275,10 +275,10 @@ Pretty soon the room will be laid out and we’ll be ready to use it to house ou
 
 But the dwarfs won’t use it as a bedroom yet. We have to specify what the room is to be used for first. To do this:
 
-* Hit “q”.
+* Hit :kbd:`q`.
 * Move the cursor near one of the beds. It will start flashing.
-* On the right, you’ll see the option “r: Make Bedroom”.
+* On the right, you’ll see the option :kbd:`r` :guilabel:`Make Bedroom`.
-* Hit “r”.
+* Hit :kbd:`r`.
 * You will now see a flashing blue square. Here’s mine, as selected from the bottom-left bed.
 
 .. image:: images/dftutorial41.png
@@ -286,17 +286,17 @@ But the dwarfs won’t use it as a bedroom yet. We have to specify what the room
 
 We could hit enter now and set the room at this size, but that would leave two beds out. So we need to make the room size bigger. With the blue square flashing…
 
-* Hit “alt+down arrow” and this will make the blue square bigger until it fills the whole room.
+* Hit :kbd:`Alt`-:kbd:`↓` and this will make the blue square bigger until it fills the whole room.
 
-You will note that the room won’t “leak” beyond the boundaries of the walls and doors. This is why we need doors, to prevent leaky rooms! Makes sense? Right? Ok… moving on…
+You will note that the room won't "leak" beyond the boundaries of the walls and doors. This is why we need doors, to prevent leaky rooms! Makes sense? Right? Ok… moving on…
 
 * Hit enter with the room set at max size, a new menu will appear on the right.
 
-This menu gives you options for the room. It will always appear when you “q” over the item you set a room’s use from. Note, you don’t have to set every bed in the room as a bedroom (although the game will let you do that). DF is smart enough to know that the room is a bedroom, and all the beds in the room should be used.
+This menu gives you options for the room. It will always appear when you :kbd:`q` over the item you set a room’s use from. Note, you don’t have to set every bed in the room as a bedroom (although the game will let you do that). DF is smart enough to know that the room is a bedroom, and all the beds in the room should be used.
 
 On the new menu you want to:
 
-* Hit “b” for “Barracks”, this will turn the “(N)” to a “(Y)”.
+* Hit :kbd:`b` for :guilabel:`Barracks`, this will turn the :guilabel:`(N)` to a :guilabel:`(Y)`.
 
 With the room set as a barracks any dwarf without their own room will use the beds in the barracks to sleep in. When you have a military, the barracks is also where dwarfs will spar and sleep when off duty.
 
@@ -305,7 +305,7 @@ Well done! We have a bedroom for our shorties to sleep in! But what’s this, so
 .. image:: images/dftutorial42.png
    :align: center
 
-…a monkey ran into our fortress, probably planning to steal something, when it came face to face with our woodcutter (the sandy-coloured dwarf). End result, chop-chop, a dead monkey! The red “M” is the dead monkey, the other red stuff is the monkey’s blood splattered everywhere. Don’t worry though, your dwarfs will soon drag the body outside and throw it on the refuse pile. This may not happen in your game, but it’s good to know what  a fight looks like when it does.
+…a monkey ran into our fortress, probably planning to steal something, when it came face to face with our woodcutter (the sandy-coloured dwarf). End result, chop-chop, a dead monkey! The red :guilabel:`M` is the dead monkey, the other red stuff is the monkey’s blood splattered everywhere. Don’t worry though, your dwarfs will soon drag the body outside and throw it on the refuse pile. This may not happen in your game, but it’s good to know what  a fight looks like when it does.
 
 That’s all for now! In the next tutorial we’ll build a fine dining room, set up some more workshops, and start to build some proper living quarters for our dwarfs. We might also build some fearsome traps! I can’t wait!