From ef3b6dc1040bbf518e35749417fa3ef6a9cf0c65 Mon Sep 17 00:00:00 2001 From: morristheaverage Date: Fri, 25 Sep 2020 16:55:02 +0100 Subject: [PATCH 1/3] Cleaned up spelling and writing style --- rst.html.markdown | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/rst.html.markdown b/rst.html.markdown index bdc73c7a..8e32ff3f 100644 --- a/rst.html.markdown +++ b/rst.html.markdown @@ -3,12 +3,13 @@ language: restructured text (RST) contributors: - ["DamienVGN", "https://github.com/martin-damien"] - ["Andre Polykanine", "https://github.com/Oire"] + - ["Tom Morris", "https://github.com/morristheaverage"] filename: restructuredtext.rst --- -RST is a file format formely created by Python community to write documentation (and so, is part of Docutils). +RST, Restructured Text, is a file format created by the Python community to write documentation. It is part of [Docutils](https://docutils.sourceforge.io/rst.html). -RST files are simple text files with lightweight syntax (comparing to HTML). +RST is a markdown language like HTML but is much more lightweight and easier to read. ## Installation @@ -39,10 +40,10 @@ A simple example of the file syntax: Main titles are written using equals signs over and under ========================================================= -Note that there must be as many equals signs as title characters. +Note that each character, including spaces, needs an equals sign above and below. -Title are underlined with equals signs too -========================================== +Title use equals signs but are only underlined +============================================== Subtitles with dashes --------------------- @@ -84,7 +85,7 @@ More complex tables can be done easily (merged columns and/or rows) but I sugges There are multiple ways to make links: -- By adding an underscore after a word : Github_ and by adding the target URL after the text (this way has the advantage to not insert unnecessary URLs inside readable text). +- By adding an underscore after a word : Github_ and by adding the target URL after the text (this way has the advantage of not inserting unnecessary URLs in the visible text). - By typing a full comprehensible URL : https://github.com/ (will be automatically converted to a link) - By making a more Markdown-like link: `Github `_ . From d9608f8894302cc6a6a053a267fbc5b74ed5a523 Mon Sep 17 00:00:00 2001 From: morristheaverage Date: Fri, 25 Sep 2020 17:02:53 +0100 Subject: [PATCH 2/3] Cleaned up writing and a typo --- rst.html.markdown | 1 - 1 file changed, 1 deletion(-) diff --git a/rst.html.markdown b/rst.html.markdown index 8e32ff3f..f63d4b2f 100644 --- a/rst.html.markdown +++ b/rst.html.markdown @@ -3,7 +3,6 @@ language: restructured text (RST) contributors: - ["DamienVGN", "https://github.com/martin-damien"] - ["Andre Polykanine", "https://github.com/Oire"] - - ["Tom Morris", "https://github.com/morristheaverage"] filename: restructuredtext.rst --- From ef8f40a46d3cb58fca005000a8ddfadbbc823c97 Mon Sep 17 00:00:00 2001 From: morristheaverage Date: Fri, 25 Sep 2020 17:05:28 +0100 Subject: [PATCH 3/3] Edited typos --- rst.html.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/rst.html.markdown b/rst.html.markdown index f63d4b2f..56d54501 100644 --- a/rst.html.markdown +++ b/rst.html.markdown @@ -41,8 +41,8 @@ Main titles are written using equals signs over and under Note that each character, including spaces, needs an equals sign above and below. -Title use equals signs but are only underlined -============================================== +Titles also use equals signs but are only underneath +==================================================== Subtitles with dashes ---------------------