LSViana / EBH-book

Evidence-Based Hiring book, in markdown, with pandoc build scripts for HTML, EPUB and PDF.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Evidence-Based Hiring book

This repo contains source and build scripts for Evidence-Based Hiring book (Amazon, GoodReads).

The book is in Pandoc’s Markdown, written using VSCode.

Requirements

  • To build HTML, EPUB and PDF, you will need Pandoc converter.
  • You'll also need MiKTeX (a LaTeX processor for Windows).
    • Download latest version from https://miktex.org/download.
    • During installation allow MiKTeX to download missing packages automatically.
    • After installation open the MiKTeX console, install the "cm-super" package via the package manager and then run "Tasks -> Refresh file name database" and "Tasks -> Update font map files".
    • Open the MiKTeX console in admin mode (you can do it from within the MiKTeX console by using the option under the Overview tab). When in admin mode, repeat the step above.
  • Once you have everything installed, run "md2all.bat" on Windows command line to build everything. If you are on Linux, try using "wine cmd.exe /c md2all.bat" to run Windows batch file.

Explanation

"md2all.bat" calls pandoc from command line to build each of the output formats. Source markdown files are in the "source" folder. In "styling" folder are the following files:

  • "epub-styling.css" is for styling EPUB (EPUB format is a collection of HTML files).
  • "html-styling.css", "html-template.html", "html-nav.js" and "html-open-links-in-new-tab.lua" are all used to generate the HTML version.
  • "pagebreak.lua" is used to improve page breaks in HTML and EPUB versions.
  • "pdf-table-size.lua" and "pdf-center-images.lua" are used to improve tables and images in PDF versions.
  • Other *.sty and *.tex files are used to generate the PDF versions (printed and digital).

License

This book is licensed under CC BY-ND 4.0 license.

About

Evidence-Based Hiring book, in markdown, with pandoc build scripts for HTML, EPUB and PDF.

License:Other


Languages

Language:TeX 40.1%Language:CSS 23.7%Language:HTML 18.0%Language:Lua 8.9%Language:JavaScript 4.6%Language:Batchfile 4.5%