From 0d723df37b205e702e50489d8d043780466b3ba3 Mon Sep 17 00:00:00 2001 From: Benjamin Chausse Date: Sat, 17 Oct 2020 00:26:58 -0400 Subject: Make README non-markdown --- README.md | 65 --------------------------------------------------------------- 1 file changed, 65 deletions(-) delete mode 100644 README.md diff --git a/README.md b/README.md deleted file mode 100644 index 0f74376..0000000 --- a/README.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Groffdown -author: Benjamin Chausse -date: 2019-09-19 -Markdown syntax with GNU/Troff-like compilation speeds. ---- - -## What is Groffdown? - -Groffdown aims to take the already existing (and well-known) -markdown syntax and make it compile at speed similar to the -ones of groff. The main compiler for markdown to pdf usually -being `pandoc`, it can be quite long to compile a document (up -to four seconds for one page documents -in some cases) unlike Groff which is known -to usually compile very quickly (0.1 second on average for -one page documents). As a proof of concept, this *README* -pages can be fully compiled using groffdown to then be used by groff. - -# Example piping workflow -Groffdown is a script which when run on a markdown document, -will convert the most typical markdown syntax into groff -(using the `ms` macros) to then send it to standard output. -Therefore, it can be piped directly into groff (or -it's related software). Here is an example of a complete piping -command: - -- groffdown .gd | refer -PS -e "-p$REFERBIB" | groff -me -ms -kejpt -T pdf > .pdf - -# Syntax goals -- Speed -- Markdown Syntax (with yaml preamble) -- LaTeX where markdown lacks - - -## Existing Syntax - -### Commands similar to markdown -- Headers (1-5) -- *Italic* -- **Bold** -- ***Bold & Italic*** -- Bullet points -- `Code blocks (in a monospaced font)` - -### Commands similar to LaTeX -- Abstract -- Inline equations -- Centered equations -- Citations - -### Commands similar to YAML -- Titles -- Authors -- Dates -- Author's Institution - -# Current issues -- All text formatings need to be on the same line (you can't start bold - on one line and finish on the other) Doing otherwise seems to trigger - an unescapable recursive loop on the groff side of things. - -# Needed implementations -- Numbered lists -- multi-macro compatibility (mom macros for urls) \ No newline at end of file -- cgit v1.2.3