Package: jemdoc
Jemdoc (0.8.0)Jemdoc is a light text-based markup language designed for creating websites. It takes a text file written with jemdoc markup, an optional configuration file and an optional menu file, and makes static websites that look something likethis one.MotivationThis revision tojemdocseeks to keep this utility tool abreast with modern standards in web development. Since 2007, new technologies and modifications have been made to HTML and CSS. Jemdoc, in its present state lacks some of the features of theHTML5standard including basic HTML markup such as:Semantic HTML tagsHTML FormsResponsive web designIn addition, CSS3 has seen some changes as well. The most important feature concerning styling is the ability to use CSS Preprocessors, that have become common in the web development world.This revision to jemdoc seeks to keep jemdoc abreast with these changesFeaturesThe first issue change in this version of jemdoc was stripping away the configuration setup the user had to manually make to start using jemdoc as describedhere. The only requirement now is for the user to have a python 2.7 interpreter andpip2available on his system. Follow theinstallationto get started with jemdoc.Secondly, jemdoc now uses MathJax for mathematical equation rendering, instead of traditional Latex. Consequently, mathematical equations are no longer images on the generated HTML page and there is no need for the user to download or support Latex on his system.This version of jemdoc takes a mobile-first approach to websites. With this approach in mind, the webpages generated by jemdoc are responsive to varying viewports and hence devices used to view the webpages. This improves the accessibility of jemdoc generated webpages on a plethora of devices.In conjuction with the mobile-first approach, HTML5 introduced the idea of semantic tags. This project embraces semantic HTML5 tags as opposed to generic<div>tags.Over the course of the years, CSS preprocessors have arisen, introducing programming languge features such as variables to CSS stylesheets. This version of jemdoc supports three CSS preprocessors namely: SCSS, SASS and LESS. This gives users more flexibillity in styling their webpages.Additionally, the original version of jemdoc lacked core HTML tags including<form>,<audio>and<video>tags. Now, these are available with jemdoc and users can embedded audio and video elements in jemdoc and create forms to receive input from users.The possiblity most important feature in this version of jemdoc is the ability to create HTML classes and ids in.jemdocfiles. This version of jemdoc takes a less opinionated approach in generating HTML webpages and gives some degree of freedom to the user. Moreover, the ability to add HTML classes and ids gives fine grained control over the styling of specific elements in the generated HTML page.InstallationTo install, make sure you have a python 2.7.* interpreter available on your laptop.Download it hereif needed.Execute the following command in the console to download the jemdoc:pip install jemdocDocumentationTo be provided soonBuilding source withmakeA Makefile has been provided for anyone that wants to build the source documents from scratch locally. The following commands serves as a guide for using the Makefile, assuming the user is currently at the root of whatever directory the user decides to build the project inPlease use `make <target>' where <target> is one of
  clean         to remove build files
  clean-pyc     to remove .pyc files
  build         to build the project for distribution
  install       to install the project locally
  create-env    to initialize project in a virtual environment in the current working directory
  init    to download project dependencies from requirements.txtLicenseThis work is the extension of the original jemdoc created byJacob Mattingley. As the original project was under a GNU license, this has been put under the same license.
For more detail concerning the license,click hereBugs/RequestPlease use theGitHub issue trackerto submit bugs and/or feature requests