feat: init

[skip ci]

docs/guide/get-started.rst

@@ -0,0 +1,70 @@
+Get Started
+===========
+
+Installation
+------------
+
+.. code-block:: shell
+
+    $ python3 -m pip install httpaste-victorykit
+    $ httpaste --help
+
+Create configuration
+--------------------
+
+.. code-block:: shell
+
+    $ httpaste default-config --dump myconfig.ini
+
+Run a local test server
+-----------------------
+
+.. code-block:: shell
+
+    $ httpaste standalone --config myconfig.ini --port 8080
+    * Serving Flask app 'httpaste' (lazy loading)                        
+    * Environment: production                                                                                                                                   
+      WARNING: This is a development server. Do not use it in a production deployment.
+      Use a production WSGI server instead.                                                                                                                     
+    * Debug mode: off                                                            
+    * Running on all addresses.                                                  
+      WARNING: This is a development server. Do not use it in a production deployment.
+    * Running on http://localhost:8080/ (Press CTRL+C to quit)
+
+Publish a Private Paste
+-----------------------
+
+.. code-block:: shell
+
+    $ echo 'My first private paste' | curl -F 'data=<-' \
+        -u myusername:mypassword \ 
+        http://localhost:8080/paste/private
+    http://localhost:8080/paste/private/UALUA9
+
+.. note::
+    If the user does not exist, they will be created upon authentication.
+
+Retrieve a Private Paste
+------------------------
+
+.. code-block:: shell
+
+    $ curl -u myusername:mypassword http://localhost:8080/paste/private/UALUA9
+    My first private paste
+
+Publish a Public Paste
+-----------------------
+
+.. code-block:: shell
+
+    $ echo 'My first public paste' | curl -F 'data=<-' \ 
+        http://localhost:8080/paste/public
+    http://localhost:8080/paste/public/X4L39J
+
+Retrieve a Public Paste
+------------------------
+
+.. code-block:: shell
+
+    $ curl http://localhost:8080/paste/public/X4L39J
+    My first public paste