added readme and fixed download instructions

Readme.md

@@ -0,0 +1,18 @@
+## Groucho - A marXup language
+
+Groucho is a janky little tool to generate an HTML file from a text containing simplified and non-intrusive markup codes. You can see the documentation, generated from a groucho file, in `examples/doc.html`.
+
+### To compile groucho
+
+The source code of Groucho is available under a Public domain or MIT license (choose whichever you prefer). The fonts provided for the example document are covered by their own licenses (X11 license for CMU and the GUST font license for latin-modern-maths), which you can find in the font directory.
+
+You clone the repo from `https://git.forkingpaths.dev/martinfouilleul/groucho.git`. Please keep in mind though that this was written as a quick side-project for my personal use, and hence is far for production quality. It is made available online only in the interest of the reader's curiosity. It may or may not be updated in the future.
+
+After cloning the repo, you should be able to compile in the source directory with :
+
+In the terminal, `cd` the the groucho directory, and type `cc -o groucho *.cpp`
+
+### To run groucho
+
+Simply type `groucho inputFile outputFile`. 
+E.g. to re-generate the html documentation, type `groucho example/doc.groucho.txt example/doc.html`

example/doc.groucho.txt

@@ -13,9 +13,9 @@
 ------------------------------------------------\
 == Intro ==
 
-Groucho is a little tool to generate an HTML file from a text containing simplified and non-intrusive markup codes.
+Groucho is a janky little tool to generate an HTML file from a text containing simplified and non-intrusive markup codes.
 
-It was written in order to ease writing blog posts for my website. Its goal is to allow to write content along with formatting instructions, aiming at the least friction, thus avoiding the need to do a second pass manually adding html tags or using a more complex editing tool, a process that is repetitive and tedious, and makes the source text less readable.
+It was written in order to ease writing blog posts for my website, aiming at the least friction.
 
 As the content I'm writting on these posts is mainly technical, Groucho is built around three main goals\s:
 
@@ -38,9 +38,9 @@ Some examples :
 
 The source code of Groucho is available under a Public domain or MIT license (choose whichever you prefer). The fonts provided for the example document are covered by their own licenses (X11 license for CMU and the GUST font license for latin-modern-maths), which you can find in the font directory.
 
-You can download the sources [url=https://www.forkingpaths.garden/download.php?id=15]HERE[/url]. Please keep in mind though that this was written as a quick side-project for my personal use, and hence is far for production quality. It is made available online only in the interest of the reader's curiosity. It may or may not be updated in the future.
+You clone the repo from https:\/\/git.forkingpaths.dev\/martinfouilleul\/groucho.git. Please keep in mind though that this was written as a quick side-project for my personal use, and hence is far for production quality. It is made available online only in the interest of the reader's curiosity. It may or may not be updated in the future.
 
-After downloading and extracting the archive, you should be able to compile in the source directory with\s:
+After cloning the repo, you should be able to compile in the source directory with\s:
 
 [code=none]cc -o groucho *.cpp[/code]
 \

example/doc.html

@@ -15,10 +15,10 @@
 </p>
 <h2> Intro </h2>
 <p>
-Groucho is a little tool to generate an HTML file from a text containing simplified and non-intrusive markup codes.
+Groucho is a janky little tool to generate an HTML file from a text containing simplified and non-intrusive markup codes.
 </p>
 <p>
-It was written in order to ease writing blog posts for my website. Its goal is to allow to write content along with formatting instructions, aiming at the least friction, thus avoiding the need to do a second pass manually adding html tags or using a more complex editing tool, a process that is repetitive and tedious, and makes the source text less readable.
+It was written in order to ease writing blog posts for my website, aiming at the least friction.
 </p>
 <p>
 As the content I'm writting on these posts is mainly technical, Groucho is built around three main goals&nbsp;:
@@ -49,11 +49,10 @@ Some examples :
 The source code of Groucho is available under a Public domain or MIT license (choose whichever you prefer). The fonts provided for the example document are covered by their own licenses (X11 license for CMU and the GUST font license for latin-modern-maths), which you can find in the font directory.
 </p>
 <p>
-You can download the sources <a href="https://www.forkingpaths.garden/download.php?id=15">HERE</a>
+You clone the repo from https://git.forkingpaths.dev/martinfouilleul/groucho.git. Please keep in mind though that this was written as a quick side-project for my personal use, and hence is far for production quality. It is made available online only in the interest of the reader's curiosity. It may or may not be updated in the future.
-. Please keep in mind though that this was written as a quick side-project for my personal use, and hence is far for production quality. It is made available online only in the interest of the reader's curiosity. It may or may not be updated in the future.
 </p>
 <p>
-After downloading and extracting the archive, you should be able to compile in the source directory with&nbsp;:
+After cloning the repo, you should be able to compile in the source directory with&nbsp;:
 </p>
 <div class="code">cc -o groucho *.cpp</div>
 <p>