Start work on a kitty website

Port the current asciidoc documentation to sphinx

docs/kittens/diff.rst

@@ -0,0 +1,129 @@
+kitty-diff - A side-by-side diff tool with syntax highlighting and images
+=============================================================================
+
+Major Features
+-----------------
+
+* Displays diffs side-by-side in the kitty terminal.
+
+* Does syntax highlighting of displayed diffs
+
+* Displays images as well as text diffs, even over SSH
+
+* Does recursive directory diffing
+
+
+.. image:: ../screenshots/diff.png
+   :alt: Screenshot, showing a sample diff
+
+.. contents::
+
+
+Installation
+---------------
+
+Simply install `kitty <https://github.com/kovidgoyal/kitty>`_.  You also need
+to have either the `git <https://git-scm.com/>`_ program or the ``diff`` program
+installed. Additionally, for syntax highlighting to work,
+`pygments <http://pygments.org/>`_ must be installed (note that pygments is
+included in the macOS kitty app).
+
+
+Usage
+--------
+
+In the kitty terminal, run::
+
+    kitty +kitten diff file1 file2
+
+to see the diff between file1 and file2.
+
+Create an alias in your shell's startup file to shorten the command, for example:
+
+.. code-block:: sh
+
+    alias d="kitty +kitten diff"
+
+Now all you need to do to diff two files is::
+
+    d file1 file2
+
+You can also pass directories instead of files to see the recursive diff of the
+directory contents.
+
+
+Keyboard controls
+----------------------
+
+=========================   ===========================
+Action                      Shortcut
+=========================   ===========================
+Quit                        ``q, Ctrl+c``
+Scroll line up              ``k, up``
+Scroll line down            ``j, down``
+Scroll page up              ``PgUp``
+Scroll page down            ``PgDn``
+Scroll to top               ``Home``
+Scroll to bottom            ``End``
+Scroll to next page         ``Space, PgDn``
+Scroll to previous page     ``PgUp``
+Scroll to next change       ``n``
+Scroll to previous change   ``p``
+Increase lines of context   ``+``
+Decrease lines of context   ``-``
+All lines of context        ``a``
+Restore default context     ``=``
+=========================   ===========================
+
+
+
+Configuring kitty-diff
+------------------------
+
+You can configure the colors used, keyboard shortcut, the diff implementation,
+the default lines of context, etc.  by creating a diff.conf in your kitty
+config folder. The default diff.conf is below.
+
+.. literalinclude:: ../../kittens/diff/diff.conf
+    :language: ini
+
+
+
+Integrating with git
+-----------------------
+
+Add the following to `~/.gitconfig`:
+
+.. code-block:: ini
+
+    [diff]
+        tool = kitty
+        guitool = kitty.gui
+    [difftool]
+        prompt = false
+        trustExitCode = true
+    [difftool "kitty"]
+        cmd = kitty +kitten diff $LOCAL $REMOTE
+    [difftool "kitty.gui"]
+        cmd = kitty kitty +kitten diff $LOCAL $REMOTE
+
+Now to use kitty-diff to view git diffs, you can simply do::
+
+    git difftool --no-symlinks --dir-diff
+
+Once again, creating an alias for this command is useful.
+
+
+Why does this work only in kitty?
+----------------------------------------
+
+The diff kitten makes use of various features that are
+:doc:`kitty only </protocol-extensions>`,  such as the
+:doc:`kitty graphics protocol </graphics-protocol>`,
+the extended keyboard protocol, etc. It also leverages
+terminal program infrastructure I created for all of kitty's other kittens to
+reduce the amount of code needed (the entire implementation is under 2000 lines
+of code).
+
+And fundamentally, it's kitty only because I wrote it for myself, and I am
+highly unlikely to use any other terminals :)

docs/kittens/hints.rst

@@ -0,0 +1,22 @@
+Hints
+==========
+
+|kitty| has a *hints mode* to select and act on arbitrary text snippets currently
+visible on the screen.  For example, you can press |sc_kitten_hints|
+to choose any URL visible on the screen and then open it using your system
+browser.
+
+.. image:: ../screenshots/hints_mode.png
+  :alt: URL hints mode
+
+Similarly, you can press |sc_kitten_hints_type_path_program| to
+select anything that looks like a path or filename and then insert it into the
+terminal, very useful for picking files from the output of a ``git`` or ``ls`` command and
+adding them to the command line for the next command.
+
+The hints kitten is very powerful to see more detailed help on its various
+options and modes of operation, use::
+
+    kitty +kitten hints --help
+
+

docs/kittens/unicode-input.rst

@@ -0,0 +1,18 @@
+Unicode input
+================
+
+You can input unicode characters by name, hex code, recently used and even an editable favorites list.
+Press |sc_input_unicode_character| to start the unicode input widget, shown below.
+
+.. image:: ../screenshots/unicode.png
+    :alt: A screenshot of the unicode input widget
+
+In *Code* mode, you enter a unicode character by typing in the hex code for the
+character and pressing enter, for example, type in ``2716`` and press enter to get
+✖. You can also choose a character from the list of recently used characters by
+typing a leading period and then the two character index and pressing Enter.
+
+In *Name* mode you instead type words from the character name and use the arrow
+keys/tab to select the character from the displayed matches. You can also type
+a leading period and the index for the match if you dont like to use arrow
+keys.