From dc5e76e90444ebaa77b1cf5b226ba219fe54dc49 Mon Sep 17 00:00:00 2001 From: Jeff MacKinnon Date: Wed, 24 Aug 2022 18:56:23 +0000 Subject: [PATCH] Upload files to '' --- README.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..d6645e5 --- /dev/null +++ b/README.md @@ -0,0 +1,16 @@ +# JMKEngineering RST2PDF Style + +This is the default JMK Engineering RST2PDF Style sheet for reports and memos. + +This year we have started using RestructuredText to develop client memos, reports, etc. We deliver them in PDF using [rst2pdf](https://rst2pdf.org). The best [handbook for RST2PDF is here](http://rst2pdf.ralsina.me/handbook.html). + +The .yaml file has everything that I need to make the reports look really close to those that I developed in MS WORD. + +## Why RestructuredText vs WORD? + +Why did I go though this process? I wanted something simple that has the ability to create complex reports with a lot of people at the same time without relying on various cloud services. + +By using a markup language and [git](https://git-scm.com) we can accomplish this with anyone in the world. From my experience WORD wasn't playing nice (even though I think is should) and a markup langauge can be edited in any text editor. No special software required. + +I can also create reports, mini-sites for special reports and pages/articles for our [main site](https://jmkengineering.com) with a common set of standards. If I wanted to copy/paste exerpts from the website into a report, it is as simple as going to the source code and ctrl-c, ctrl-v. Everything will look exactly the way that I want. +