[commanding] add Organization section

14 files changed, 120 insertions, 2 deletions

diff --git a/Makefile b/Makefile
index ff1e6d3..9ab0169 100644
--- a/Makefile
+++ b/Makefile
@@ -1,5 +1,6 @@
 all: pdf html
 
+
 pdf:
 	mkdir -p build
 	pdflatex -output-directory build $(NAME).tex
@@ -7,8 +8,14 @@ pdf:
 
 html:
 	mkdir -p html
-	make4ht -d html $(NAME).tex
-	make4ht -d html $(NAME).tex
+
+ifeq ($(findstring htmlconf.cfg,$(wildcard *.cfg)),)
+	$(eval HTMLCONF=)
+else
+	$(eval HTMLCONF=--config htmlconf)
+endif
+	make4ht -d html $(HTMLCONF) $(NAME).tex
+	make4ht -d html $(HTMLCONF) $(NAME).tex
 	cat ../custom.css >> html/$(NAME).css
 	rm $(NAME).4ct $(NAME).4tc $(NAME).aux $(NAME).dvi $(NAME).idv $(NAME).lg $(NAME).log $(NAME).tmp $(NAME).xref $(NAME).css $(NAME).html
 
diff --git a/commanding/commanding.tex b/commanding/commanding.tex
index ce28d37..277388b 100644
--- a/commanding/commanding.tex
+++ b/commanding/commanding.tex
@@ -63,6 +63,7 @@ Depending on the team/community that you run wurms with, there can be some other
 This section should give you an overview over some general game and squad mechanics that are applicable for more than just Triple Trouble.
 
 The wiki also has a good overview over a lot of squad mechanics, see \href{https://wiki.guildwars2.com/wiki/Squad}{the \emph{Squad} article}.
+If you already know how squads are working in Guild Wars 2, or if you prefer to read the wiki article about it, feel free to skip this section.
 
 
 \subsection{Tagging Up}
@@ -115,4 +116,97 @@ For Triple Trouble, subsquads are mostly used to have the special roles (such as
 Additionally, if you use the party chat while in a squad, it will only send the message to your current subsquad - this allows blockers to coordinate without affecting the rest of the zerg.
 If you want to message the whole squad, you can use the squad chat (\texttt{/squad} or \texttt{/d}).
 
+
+\subsection{Markers}
+
+If you are the commander or a lieutenant in a squad, you can place location and object markers.
+There are eight markers available:
+
+\newcommand{\markerimg}[1]{\parbox[c]{2em}{\includegraphics[width=2em]{images/mrk-#1.png}}}
+\begin{tabular}{cccc}
+  \textbf{Icon} & \textbf{Name} & \textbf{Color} & \textbf{Number} \\ \hline
+  \markerimg{arrow} & Arrow & lime & 1 \\
+  \markerimg{circle} & Circle & purple & 2 \\
+  \markerimg{heart} & Heart & red & 3 \\
+  \markerimg{square} & Square & blue & 4 \\
+  \markerimg{star} & Star & green & 5 \\
+  \markerimg{spiral} & Spiral & cyan & 6 \\
+  \markerimg{triangle} & Triangle & magenta & 7 \\
+  \markerimg{x} & X & yellow & 8 \\
+\end{tabular}
+\let\markerimg\undefined
+
+By default, you can set a location marker by hovering with your mouse over the location that you want to mark, and then pressing \texttt{Alt + NUMBER}.
+You can remove a location marker by hovering over the marked location and pressing \texttt{Alt + NUMBER} again.
+Of course, you can re-bind each single marker to a different key in the options.
+
+You can set object markers by selecting an object (such as a player) and then pressing \texttt{Alt + Shift + NUMBER}.
+Unlike location markers, object markers will move with their object, and the marker will always be hovering over the object.
+You can use the same symbol for a location and an object without unsetting the other one, e.g. you can mark a location with Arrow without losing the object marker Arrow.
+
+
+\subsection{Squad Broadcasts}
+
+Squad broadcasts are a special way to communicate in squads, in addition to the normal squad chat.
+A squad broadcast is a text that will appear in big letters in the middle of every squad member's screen.
+
+\begin{figure}[ht]
+  \centering
+  \includegraphics[width=0.5\textwidth]{images/squad-broadcast-example.png}
+  \caption{Example of a squad broadcast.}
+\end{figure}
+
+You can create a broadcast by typing the text in the small textbox above the squad UI.
+Alternatively, you can use the shortcut \texttt{Shift + Enter} to quickly place your cursor into the broadcast textbox.
+
+\begin{figure}[ht]
+  \centering
+  \includegraphics[width=0.5\textwidth]{images/squad-broadcast-textbox.png}
+  \caption{The textbox for squad broadcasts.}
+\end{figure}
+
+Note that some in-game messages are also done in the same style as squad broadcasts.
+For example, when all extractors are filled at Crimson, a \enquote{broadcast} will announce the burn phase.
+
+
+\section{Organization}
+
+As a commander, you are not just responsible for being there throughout the event.
+There are some additional tasks that you have to do in order to ensure a smooth run.
+For this part, we will assume that you have three commanders ready.
+
+First of all, you should find a map.
+All the groups and communities that organize Triple Trouble on a regular basis use the \emph{IP Coordination Spreadsheet} in order to not clash with each other.
+If you organize a run, make sure that you are on a map that is not yet claimed, and make sure that you claim the map for your group.
+
+In order to find out on which IP you are on, you can use the \texttt{/ip} in-game command.
+This will give you back a bunch of numbers separated by a dot, and a \texttt{:0} at the end.
+This IP allows you to identify the map instance that you are on.
+Normally, the last part before the colon is enough to uniquely identify the map, which is why we only care about that - it is easier to keep one number in mind than 4.
+
+\begin{figure}[ht]
+  \centering
+  \includegraphics[width=0.5\textwidth]{images/ip-output.png}
+  \caption{IP output. In this example, \emph{98} would be the relevant number.}
+\end{figure}
+
+Make sure to divide the wurm heads between the commanders, so that each commander has a head assigned.
+There are no set rules on how to decide, so communicate if you have specific preferences!
+As for TTT, keep in mind that trainees have the first pick over fulltags.
+
+Once all commanders are ready and on the correct map, you can tag up by creating your squad.
+Usually, the commanders will spread out a bit - the Cobalt squad to the north of \emph{Firthside Vigil Waypoint}, the Amber squad to the east and the Crimson squad to the south.
+Make sure that you are not standing right below the waypoint, otherwise your tag will not be visible on the (mini) map.
+
+Now that your squads are open, it is time to get people joining in.
+You can advertise your squad on the LFG tool, usually in the \emph{Open World} $\rightarrow$ \emph{World Bosses} category.
+You can use the map and say chat to advertise the run to people already on the map and get them to join one of the squads.
+And if you are on TeamSpeak or Discord, you can post your \enquote{sqjoin} there, so people can use it to join your squad.
+
+While you are waiting for people to join, make sure that you have the special roles (egg blockers and husk handlers) that you need, and ensure that people in your squad are actually on the correct map as well.
+
+Note that this part should be done about 30 minutes before the event starts.
+The later you open your squads and the LFG, the harder it is to get people for the event.
+The longer you have to wait for people, the less time you have for explanations and the dry run!
+
 \end{document}
diff --git a/commanding/htmlconf.cfg b/commanding/htmlconf.cfg
new file mode 100644
index 0000000..930da6d
--- /dev/null
+++ b/commanding/htmlconf.cfg
@@ -0,0 +1,17 @@
+\Preamble{xhtml}
+\Configure{graphics*}
+    {jpg}
+    {%
+        \Picture[pict]{\csname Gin@base\endcsname .jpg
+              \space width="\the\dimexpr \expandafter\csname Gin@req@width\endcsname * 1.5"}%
+        \special{t4ht+@File: \csname Gin@base\endcsname.jpg}
+    }
+\Configure{graphics*}
+    {png}
+    {%
+        \Picture[pict]{\csname Gin@base\endcsname .png
+            \space width="\the\dimexpr \expandafter\csname Gin@req@width\endcsname * 1.5"}%
+        \special{t4ht+@File: \csname Gin@base\endcsname.png}
+    }
+\begin{document}
+\EndPreamble
diff --git a/commanding/images/ip-output.png b/commanding/images/ip-output.png
new file mode 100644
index 0000000..5d4012a
--- /dev/null
+++ b/commanding/images/ip-output.png
diff --git a/commanding/images/mrk-arrow.png b/commanding/images/mrk-arrow.png
new file mode 100644
index 0000000..85e4f2e
--- /dev/null
+++ b/commanding/images/mrk-arrow.png
diff --git a/commanding/images/mrk-circle.png b/commanding/images/mrk-circle.png
new file mode 100644
index 0000000..5ecd1d4
--- /dev/null
+++ b/commanding/images/mrk-circle.png
diff --git a/commanding/images/mrk-heart.png b/commanding/images/mrk-heart.png
new file mode 100644
index 0000000..0765199
--- /dev/null
+++ b/commanding/images/mrk-heart.png
diff --git a/commanding/images/mrk-spiral.png b/commanding/images/mrk-spiral.png
new file mode 100644
index 0000000..62d2c02
--- /dev/null
+++ b/commanding/images/mrk-spiral.png
diff --git a/commanding/images/mrk-square.png b/commanding/images/mrk-square.png
new file mode 100644
index 0000000..6041f5a
--- /dev/null
+++ b/commanding/images/mrk-square.png
diff --git a/commanding/images/mrk-star.png b/commanding/images/mrk-star.png
new file mode 100644
index 0000000..586e369
--- /dev/null
+++ b/commanding/images/mrk-star.png
diff --git a/commanding/images/mrk-triangle.png b/commanding/images/mrk-triangle.png
new file mode 100644
index 0000000..723e013
--- /dev/null
+++ b/commanding/images/mrk-triangle.png
diff --git a/commanding/images/mrk-x.png b/commanding/images/mrk-x.png
new file mode 100644
index 0000000..b207061
--- /dev/null
+++ b/commanding/images/mrk-x.png
diff --git a/commanding/images/squad-broadcast-example.png b/commanding/images/squad-broadcast-example.png
new file mode 100644
index 0000000..6967eba
--- /dev/null
+++ b/commanding/images/squad-broadcast-example.png
diff --git a/commanding/images/squad-broadcast-textbox.png b/commanding/images/squad-broadcast-textbox.png
new file mode 100644
index 0000000..da68e2e
--- /dev/null
+++ b/commanding/images/squad-broadcast-textbox.png