1 files changed, 151 insertions, 0 deletions
diff --git a/docs/user-guide/user-guide-en.asciidoc b/docs/user-guide/user-guide-en.asciidoc
new file mode 100644
index 0000000..cd091c6
--- /dev/null
+++ b/docs/user-guide/user-guide-en.asciidoc
@@ -0,0 +1,151 @@
+// TODO: nakonfigurovat v CMake asciidoctor-pdf, je potřeba pár `gem install`
+// https://github.com/asciidoctor/asciidoctor-pdf/blob/master/README.adoc
+// https://github.com/asciidoctor/asciidoctor-pdf/blob/master/docs/theming-guide.adoc
+
+logdiag: User Guide
+===================
+Přemysl Janouch <p@janouch.name>
+v0.2, 2018-06-25
+:toc: left
+:sectnums:
+:xrefstyle: short
+
+image::logdiag-en.png[]
+
+<<<
+
+Introduction
+------------
+This document will guide you through the application and help to familiarize you
+with it. The description of tasks mainly targets the Microsoft Windows
+operating system, though it's also valid for other operating systems to
+a certain extent.
+
+Getting the application
+-----------------------
+Download the newest version of the application at the following web address:
+https://git.janouch.name/p/logdiag.
+
+// TODO: aktualizovat obrázek pro anglickou Gitea
+[[github-download]]
+.The download menu at GitHub
+image::github.png[]
+
+While on the web, look for a tab entitled ``Releases'' and click on it. A menu
+with versions will appear with files for download listed under ``Downloads''
+headings.  The installation file for Microsoft Windows is named in the style of
+``logdiag-__version__-Windows-x86.exe''.
+
+Installation
+------------
+The installation process is quite straight-forward. After the initial screen a
+license agreement is required. Next, choose a folder in which to install the
+application and another one for placement in the Start menu. So long as no
+unexpected errors have occurred, all that's left is confirming a successful
+installation.
+
+WARNING: If the application is installed into a folder where a previous
+installation is already located, problems may arise. Although it is possible to
+do so, don't try to install multiple copies parallely either, for the same
+reasons. Remove the current installation first, for example by using the
+shortcut located in the Start menu.
+
+Operations with objects
+-----------------------
+
+////
+
+TODO: zkusit restrukturalizovat na:
+
+4. Operace s objekty
+   4.1 Základní operace
+       4.1.1 Výběr
+       4.1.2 Přesun
+       4.1.3 Odstranění
+   4.2 Značky
+       4.2.1 Vložení
+       4.2.2 Otáčení
+   4.3 Spojení
+       4.3.1 Tvorba
+
+////
+
+Each diagram consists of objects, and these are accompanied by the operations
+described below. To cancel any current operation, press the Escape key.
+
+Selecting objects
+~~~~~~~~~~~~~~~~~
+Select single objects by left-clicking on them. They will get highlighted with
+red color in reaction to this. To select multiple objects, hold the Shift key
+while clicking.
+
+// XXX: nelze zarovnat obrázek na střed zároveň s caption
+[[select-objects]]
+.Selecting objects inside an area
+image::select-objects.png[]
+
+Alternatively drag the mouse from free space within the diagram into the area,
+see <<select-objects>>. Objects contained in this rectangle will be
+selected. The selection may later be dismissed by just clicking into free space.
+
+Moving objects
+~~~~~~~~~~~~~~
+Moving of objects is done by dragging them with the mouse onto the desired
+place. If these objects form a part of the current selection, the whole
+selection is moved. The selection may also be moved using cursor keys.
+
+Removing objects
+~~~~~~~~~~~~~~~~
+Remove objects either by pressing the Delete key or from the application menu.
+
+Inserting symbols
+~~~~~~~~~~~~~~~~~
+_Symbols_ constitute the most important kind of objects. Insert them into the
+diagram by choosing one from the symbol menu located on the left side of the
+main application window, see <<select-symbol>>, and dragging it onto the diagram
+where you want the symbol to be placed.
+
+[[select-symbol]]
+.Choosing a symbol from the menu
+image::select-symbol.png[]
+
+Rotating symbols
+~~~~~~~~~~~~~~~~
+Rotate a symbol inserted into the diagram by right-clicking on it.
+
+Connecting terminals
+~~~~~~~~~~~~~~~~~~~~
+A point intended for creation of connections between symbols or other
+connections is called a _terminal_. To lead a connection out of it, first
+hover it with the mouse pointer, so it gets visibly highlighted with a circle.
+Then press the left mouse button and drag the pointer onto the place where you
+want the connection to end.
+
+// XXX: nelze sloučit do jedné figure
+[[create-connection]]
+.Interconnecting terminals of two symbols
+image:create-connection-begin.png[]
+&nbsp;...&nbsp;
+image:create-connection-end.png[]
+
+Frequent problems
+-----------------
+
+Can't open a saved diagram
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+When saving, ensure that the filename you've typed in contains the ``.ldd''
+suffix. If not, it won't show up in the dialog for opening diagrams. In case
+you've already saved a file without an extension, you may fix this situation by
+adding the suffix to its name.
+
+How do I print a diagram?
+~~~~~~~~~~~~~~~~~~~~~~~~~
+The current version of application is not able to print directly. To print out a
+created diagram, you may use the PrintScreen key to capture a screenshot, then
+insert it to, for example, Paint, and print it from inside the graphics editor.
+
+I miss labels
+~~~~~~~~~~~~~
+Similarly to the previous case, this functionality doesn't exist yet, but it is
+possible to get around this limitation using a graphics editor.
+