add light aquifer tap library blueprint and docs

data/blueprints/library/aquifer_tap.csv

@@ -0,0 +1,61 @@
+#notes label(help)
+"This blueprint will help you get a safe, everlasting source of fresh water from a light aquifer."
+""
+Here's the procedure:
+""
+1) Dig a tunnel from where you want the water to end up (e.g. your well cistern) off to an unused portion of the map.
+""
+"2) From the end of that tunnel, dig a staircase straight up to the z-level just below the lowest aquifer level. Also dig the staircase down one z-level."
+""
+"3) From the bottom of the staircase (the z-level below where the water will flow to your cisterns), dig a straight, one-tile wide tunnel to the edge of the map. Smooth the map edge tile and carve a fortification. The water can flow through the fortification and off the map, allowing the dwarves to dig out the aquifer tap without drowning."
+""
+4) Place a lever-controlled floodgate in the drainage tunnel and open the floodgate.
+""
+"5) If you care about how nice things look, haul away any boulders and smooth the tiles. You won't be able to access any of this area once it fills up with water!"
+""
+"6) Apply this blueprint to the z-level above the top of the staircase, inside the lowest aquifer level. Do not unpause until after the next step."
+""
+"7) Damp tiles cancel dig designations if the tile is currently hidden, so to avoid having to re-apply this blueprint after every tile your dwarves dig, position the cursor straight up (north) of the left-most tile designated for digging and straight left (west) of the topmost designated tile and run the following commands in the DFHack console:"
+tiletypes-command f any ; f designated 1 ; p any ; p hidden 0 ; r 23 23 1
+tiletypes-here
+""
+"8) Unpause and dig out the tap. If you care about appearances, haul away any boulders and feel free to remove the ramps (d-z). The water will safely flow down the staircase, through the open floodgate, and off the map until you choose to close the floodgate."
+
+"9) Once everything is dug out and all dwarves are out of the waterways, close the floodgate. Your cisterns will fill with water. Since the waterway to your cisterns is depressurized, the cisterns will stay forever full, but will not flood."
+""
+A diagram might be useful. Here is a vertical view through the z-levels. This blueprint goes at the top:
+""
+j  <- center of this blueprint
+i
+... <- make this as tall as you need
+i
+i <- cistern outlet level
+u <- drainage level
+""
+"Good luck! If done right, this method is the safest way to supply your fort with clean water."
+#dig start(13 13 center of tap) light aquifer water collector
+
+,,,,,,,,,,,,r
+,,,,,,,,,,,,r
+,,,,,r,r,r,r,r,r,r,r,r,r,r,r,r,r,r
+,,,,,,,,,,,,r
+,,,r,,,,,,,,,r,,,,,,,,,r
+,,,r,,,,,r,r,r,r,r,r,r,r,r,,,,,r
+,,,r,,,,,,,,,r,,,,,,,,,r
+,,,r,,,r,,,,,,r,,,,,,r,,,r
+,,,r,,,r,,,,,r,r,r,,,,,r,,,r
+,,,r,,,r,,,,,,r,,,,,,r,,,r
+,,,r,,,r,,,r,,,r,,,r,,,r,,,r
+,r,r,r,r,r,r,r,r,r,r,r,j,r,r,r,r,r,r,r,r,r,r,r
+,,,r,,,r,,,r,,,r,,,r,,,r,,,r
+,,,r,,,r,,,,,,r,,,,,,r,,,r
+,,,r,,,r,,,,,r,r,r,,,,,r,,,r
+,,,r,,,r,,,,,,r,,,,,,r,,,r
+,,,r,,,,,,,,,r,,,,,,,,,r
+,,,r,,,,,r,r,r,r,r,r,r,r,r,,,,,r
+,,,r,,,,,,,,,r,,,,,,,,,r
+,,,,,,,,,,,,r
+,,,,,r,r,r,r,r,r,r,r,r,r,r,r,r,r,r
+,,,,,,,,,,,,r
+,,,,,,,,,,,,r
+

docs/guides/quickfort-library-guide.rst

@@ -92,6 +92,8 @@ Services level
   :target: https://drive.google.com/file/d/1jlGr6tAhS8i-XFTz8gowTZBhXcfjfL_L
   :align: center
 
+.. _example-plumbing-to-fill-cisterns:
+
 Example plumbing to fill cisterns
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 
@@ -186,14 +188,38 @@ Miscellaneous
 
 Extra blueprints that are useful in specific situations.
 
+- :source:`library/aquifer_tap.csv <data/blueprints/library/aquifer_tap.csv>`
 - :source:`library/embark.csv <data/blueprints/library/embark.csv>`
 - :source:`library/pump_stack.csv <data/blueprints/library/pump_stack.csv>`
 
+Light Aquifer Tap
+~~~~~~~~~~~~~~~~~
+
+The aquifer tap helps you create a safe, everlasting source of fresh water from
+a light aquifer. See the step-by-step guide, including informaton on how to
+create a drainage system so your dwarves don't drown when digging the tap, by
+running ``quickfort run library/aquifer_tap.csv -n /help``.
+
+You can see how to nullify the water pressure (so you don't flood your fort) in
+the `Dreamfort screenshot above <example-plumbing-to-fill-cisterns>`.
+
+Blueprint spreadsheet also available
+`online <https://docs.google.com/spreadsheets/d/1kwuCipF9FYAHNP9C_XlMpqVseaPu4SmL9YLUSQkbW4s/edit#gid=611877584>`__
+
+Post-embark
+~~~~~~~~~~~
+
 The embark blueprints are useful directly after embark. It contains a ``#build``
 blueprint that builds important starting workshops (mason, carpenter, mechanic,
 and craftsdwarf) and a ``#place`` blueprint that lays down a pattern of useful
 starting stockpiles.
 
+Pump Stack
+~~~~~~~~~~
+
 The pump stack blueprints help you move water and magma up to move convenient
 locations in your fort. See the step-by-step guide for using it by running
 ``quickfort run library/pump_stack.csv -n /help``.
+
+Blueprint spreadsheet also available
+`online <https://docs.google.com/spreadsheets/d/1TP2n-W-O9f30Dtl6yoTcn6yczWQRu11iM7U6TEE9634/edit#gid=0>`__