', 'Path of the markdown file to convert')
9 | .option('-c, --cwd [path]', 'Current working directory')
10 | .option('-p, --phantom-path [path]', 'Path to phantom binary')
11 | .option('-h, --runnings-path [path]', 'Path to runnings (header, footer)')
12 | .option('-s, --css-path [path]', 'Path to custom CSS file')
13 | .option('-z, --highlight-css-path [path]', 'Path to custom highlight-CSS file')
14 | .option('-m, --remarkable-options [json-options]', 'Options to pass to remarkable')
15 | .option('-f, --paper-format [format]', '"A3", "A4", "A5", "Legal", "Letter" or "Tabloid"')
16 | .option('-r, --paper-orientation [orientation]', '"portrait" or "landscape"')
17 | .option('-b, --paper-border [measurement]', 'Supported dimension units are: "mm", "cm", "in", "px"')
18 | .option('-d, --render-delay [millis]', 'Delay before rendering the PDF')
19 | .option('-t, --load-timeout [millis]', 'Timeout before the page is rendered in case `page.onLoadFinished` isn\'t fired')
20 | .option('-o, --out [path]', 'Path of where to save the PDF')
21 | .parse(process.argv)
22 |
23 | if (program.args.length === 0) program.help()
24 |
25 | program.out = program.out || program.args[0].replace(/\.m(ark)?d(own)?/gi, '') + '.pdf'
26 |
27 | var opts = {
28 | cwd: program.cwd,
29 | phantomPath: program.phantomPath,
30 | runningsPath: program.runningsPath,
31 | cssPath: program.cssPath,
32 | highlightCssPath: program.highlightCssPath,
33 | remarkable: program.remarkableOptions ? JSON.parse(program.remarkableOptions) : null,
34 | paperFormat: program.paperFormat,
35 | paperOrientation: program.paperOrientation,
36 | paperBorder: program.paperBorder,
37 | renderDelay: program.renderDelay,
38 | loadTimeout: program.loadTimeout
39 | }
40 |
41 | markdownpdf(opts).concat.from(program.args).to(program.out, function (err) {
42 | if (err) throw err
43 | })
44 |
--------------------------------------------------------------------------------
/css/highlight.css:
--------------------------------------------------------------------------------
1 | .hljs{display:block;overflow-x:auto;padding:0.5em;background:#f0f0f0;-webkit-text-size-adjust:none}.hljs,.hljs-subst,.hljs-tag .hljs-title,.nginx .hljs-title{color:black}.hljs-string,.hljs-title,.hljs-constant,.hljs-parent,.hljs-tag .hljs-value,.hljs-rules .hljs-value,.hljs-preprocessor,.hljs-pragma,.haml .hljs-symbol,.ruby .hljs-symbol,.ruby .hljs-symbol .hljs-string,.hljs-template_tag,.django .hljs-variable,.smalltalk .hljs-class,.hljs-addition,.hljs-flow,.hljs-stream,.bash .hljs-variable,.apache .hljs-tag,.apache .hljs-cbracket,.tex .hljs-command,.tex .hljs-special,.erlang_repl .hljs-function_or_atom,.asciidoc .hljs-header,.markdown .hljs-header,.coffeescript .hljs-attribute{color:#800}.smartquote,.hljs-comment,.hljs-annotation,.diff .hljs-header,.hljs-chunk,.asciidoc .hljs-blockquote,.markdown .hljs-blockquote{color:#888}.hljs-number,.hljs-date,.hljs-regexp,.hljs-literal,.hljs-hexcolor,.smalltalk .hljs-symbol,.smalltalk .hljs-char,.go .hljs-constant,.hljs-change,.lasso .hljs-variable,.makefile .hljs-variable,.asciidoc .hljs-bullet,.markdown .hljs-bullet,.asciidoc .hljs-link_url,.markdown .hljs-link_url{color:#080}.hljs-label,.hljs-javadoc,.ruby .hljs-string,.hljs-decorator,.hljs-filter .hljs-argument,.hljs-localvars,.hljs-array,.hljs-attr_selector,.hljs-important,.hljs-pseudo,.hljs-pi,.haml .hljs-bullet,.hljs-doctype,.hljs-deletion,.hljs-envvar,.hljs-shebang,.apache .hljs-sqbracket,.nginx .hljs-built_in,.tex .hljs-formula,.erlang_repl .hljs-reserved,.hljs-prompt,.asciidoc .hljs-link_label,.markdown .hljs-link_label,.vhdl .hljs-attribute,.clojure .hljs-attribute,.asciidoc .hljs-attribute,.lasso .hljs-attribute,.coffeescript .hljs-property,.hljs-phony{color:#88f}.hljs-keyword,.hljs-id,.hljs-title,.hljs-built_in,.css .hljs-tag,.hljs-javadoctag,.hljs-phpdoc,.hljs-dartdoc,.hljs-yardoctag,.smalltalk .hljs-class,.hljs-winutils,.bash .hljs-variable,.apache .hljs-tag,.hljs-type,.hljs-typename,.tex .hljs-command,.asciidoc .hljs-strong,.markdown .hljs-strong,.hljs-request,.hljs-status{font-weight:bold}.asciidoc .hljs-emphasis,.markdown .hljs-emphasis{font-style:italic}.nginx .hljs-built_in{font-weight:normal}.coffeescript .javascript,.javascript .xml,.lasso .markup,.tex .hljs-formula,.xml .javascript,.xml .vbscript,.xml .css,.xml .hljs-cdata{opacity:0.5}
--------------------------------------------------------------------------------
/html5bp/README.md:
--------------------------------------------------------------------------------
1 | # [HTML5 Boilerplate](http://html5boilerplate.com)
2 |
3 | HTML5 Boilerplate is a professional front-end template for building fast,
4 | robust, and adaptable web apps or sites.
5 |
6 | This project is the product of many years of iterative development and combined
7 | community knowledge. It does not impose a specific development philosophy or
8 | framework, so you're free to architect your code in the way that you want.
9 |
10 | * Source: [https://github.com/h5bp/html5-boilerplate](https://github.com/h5bp/html5-boilerplate)
11 | * Homepage: [http://html5boilerplate.com](http://html5boilerplate.com)
12 | * Twitter: [@h5bp](http://twitter.com/h5bp)
13 |
14 |
15 | ## Quick start
16 |
17 | Choose one of the following options:
18 |
19 | 1. Download the latest stable release from
20 | [html5boilerplate.com](http://html5boilerplate.com/) or a custom build from
21 | [Initializr](http://www.initializr.com).
22 | 2. Clone the git repo — `git clone
23 | https://github.com/h5bp/html5-boilerplate.git` - and checkout the tagged
24 | release you'd like to use.
25 |
26 |
27 | ## Features
28 |
29 | * HTML5 ready. Use the new elements with confidence.
30 | * Cross-browser compatible (Chrome, Opera, Safari, Firefox 3.6+, IE6+).
31 | * Designed with progressive enhancement in mind.
32 | * Includes [Normalize.css](http://necolas.github.com/normalize.css/) for CSS
33 | normalizations and common bug fixes.
34 | * The latest [jQuery](http://jquery.com/) via CDN, with a local fallback.
35 | * The latest [Modernizr](http://modernizr.com/) build for feature detection.
36 | * IE-specific classes for easier cross-browser control.
37 | * Placeholder CSS Media Queries.
38 | * Useful CSS helpers.
39 | * Default print CSS, performance optimized.
40 | * Protection against any stray `console.log` causing JavaScript errors in
41 | IE6/7.
42 | * An optimized Google Analytics snippet.
43 | * Apache server caching, compression, and other configuration defaults for
44 | Grade-A performance.
45 | * Cross-domain Ajax and Flash.
46 | * "Delete-key friendly." Easy to strip out parts you don't need.
47 | * Extensive inline and accompanying documentation.
48 |
49 |
50 | ## Documentation
51 |
52 | Take a look at the [documentation table of contents](doc/TOC.md). This
53 | documentation is bundled with the project, which makes it readily available for
54 | offline reading and provides a useful starting point for any documentation you
55 | want to write about your project.
56 |
57 |
58 | ## Contributing
59 |
60 | Anyone and everyone is welcome to [contribute](CONTRIBUTING.md). Hundreds of
61 | developers have helped make the HTML5 Boilerplate what it is today.
62 |
--------------------------------------------------------------------------------
/test/fixtures/ipsum.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 | This is a paragraph. Cupcake ipsum dolor sit amet. Tiramisu liquorice gummies powder. Biscuit pastry pastry cake candy gummies carrot cake gingerbread. Gummi bears tart cupcake bonbon sugar plum biscuit. Icing marzipan tootsie roll. Pie gingerbread dragée wypas cookie. Faworki bonbon topping sweet soufflé jelly.
8 | And another paragraph. Jelly beans tootsie roll fruitcake toffee wypas chupa chups pudding. Soufflé muffin halvah powder sugar plum cake. Toffee cookie biscuit faworki pastry. Bonbon gummi bears topping caramels marshmallow. Chupa chups candy canes toffee. Powder powder candy canes pastry. Tootsie roll marshmallow powder.
9 | These words are emphasized
Also these words are emphasized
10 | These words are strong emphasized
Also these words are strong emphasized
11 |
12 | This is a very simple blockquote
13 |
14 |
15 | - This
16 | - is
17 | - an
18 | - unordered
19 | - list.
20 |
21 | And...
22 |
23 | - This
24 | - is
25 | - an
26 | - ordered
27 | - list.
28 |
29 | This is an example link.
This is an example link with a title.
30 | This is a image
31 | this is a line of code
32 | And these are several lines of code. Pudding sesame snaps cupcake bonbon cupcake. Icing macaroon donut.
33 |
34 | More code. Donut cheesecake chocolate cake. Tart pudding wafer dessert chocolate bar jelly-o apple pie dessert. Carrot cake apple pie pie liquorice oat cake lollipop pastry caramels. Jelly-o sesame snaps gummi bears.
35 |
36 | And more. Sugar plum lemon drops chupa chups chocolate pastry. Faworki applicake applicake brownie topping liquorice chocolate liquorice icing. Cake pudding pudding cake candy sugar plum soufflé.`
37 | And that's all ...
38 | This is an extremely simple and basic guide. To understand a lot better this kind of dark magic called markdown, logically I recommend the official wiki of the creator. Go, run, jump to the site of John Gruber.
39 |
--------------------------------------------------------------------------------
/phantom/render.js:
--------------------------------------------------------------------------------
1 | var system = require('system')
2 | var page = require('webpage').create()
3 | var fs = require('fs')
4 | var os = require('system').os
5 |
6 | // Read in arguments
7 | var args = ['in', 'out', 'cwd', 'runningsPath', 'cssPath', 'highlightCssPath', 'paperFormat', 'paperOrientation', 'paperBorder', 'renderDelay', 'loadTimeout'].reduce(function (args, name, i) {
8 | args[name] = system.args[i + 1]
9 | return args
10 | }, {})
11 |
12 | var html5bpPath = page.libraryPath + '/../html5bp'
13 |
14 | // Resources don't load in windows with file protocol
15 | var isWin = os.name === 'windows'
16 | var protocol = isWin ? 'file:///' : 'file://'
17 |
18 | var html = fs.read(html5bpPath + '/index.html')
19 | .replace(/\{\{baseUrl\}\}/g, protocol + html5bpPath)
20 | .replace('{{content}}', fs.read(args.in))
21 |
22 | page.setContent(html, protocol + args.cwd + '/markdown-pdf.html')
23 |
24 | // Add custom CSS to the page
25 | page.evaluate(function (cssPaths) {
26 | var head = document.querySelector('head')
27 |
28 | cssPaths.forEach(function (cssPath) {
29 | var css = document.createElement('link')
30 | css.rel = 'stylesheet'
31 | css.href = cssPath
32 |
33 | head.appendChild(css)
34 | })
35 | }, [args.cssPath, args.highlightCssPath].map(function (cssPath) {
36 | return (isWin ? protocol : '') + cssPath
37 | }))
38 |
39 | // Set the PDF paper size
40 | page.paperSize = paperSize(args.runningsPath, { format: args.paperFormat, orientation: args.paperOrientation, border: isJson(args.paperBorder) ? JSON.parse(args.paperBorder) : args.paperBorder })
41 |
42 | args.renderDelay = parseInt(args.renderDelay, 10)
43 |
44 | if (args.renderDelay) {
45 | setTimeout(render, args.renderDelay)
46 | } else {
47 | var loadTimeout = setTimeout(render, parseInt(args.loadTimeout, 10))
48 | page.onLoadFinished = function () {
49 | clearTimeout(loadTimeout)
50 | render()
51 | }
52 | }
53 |
54 | function render () {
55 | page.render(args.out)
56 | page.close()
57 | window.phantom.exit(0)
58 | }
59 |
60 | function paperSize (runningsPath, obj) {
61 | var runnings = require(runningsPath)
62 |
63 | // encapsulate .contents into phantom.callback()
64 | // Why does phantomjs not support Array.prototype.forEach?!
65 | var keys = ['header', 'footer']
66 |
67 | for (var i = 0; i < keys.length; i++) {
68 | var which = keys[i]
69 |
70 | if (runnings[which] && runnings[which].contents && typeof runnings[which].contents === 'function') {
71 | obj[which] = {
72 | contents: window.phantom.callback(runnings[which].contents)
73 | }
74 |
75 | if (runnings[which].height) {
76 | obj[which].height = runnings[which].height
77 | }
78 | }
79 | }
80 |
81 | return obj
82 | }
83 |
84 | function isJson (str) { try { JSON.parse(str) } catch (e) { return false } return true }
85 |
--------------------------------------------------------------------------------
/test/fixtures/ipsum.md:
--------------------------------------------------------------------------------
1 | # A First Level Header
2 | ## A Second Level Header
3 | ### A Third Level Header
4 | #### A Fourth Level Header
5 | ##### A Fifth Level Header
6 | ###### A Sixth Level Header
7 |
8 |
9 |
10 | This is a paragraph. Cupcake ipsum dolor sit amet. Tiramisu liquorice gummies powder. Biscuit pastry pastry cake candy gummies carrot cake gingerbread. Gummi bears tart cupcake bonbon sugar plum biscuit. Icing marzipan tootsie roll. Pie gingerbread dragée wypas cookie. Faworki bonbon topping sweet soufflé jelly.
11 |
12 | And another paragraph. Jelly beans tootsie roll fruitcake toffee wypas chupa chups pudding. Soufflé muffin halvah powder sugar plum cake. Toffee cookie biscuit faworki pastry. Bonbon gummi bears topping caramels marshmallow. Chupa chups candy canes toffee. Powder powder candy canes pastry. Tootsie roll marshmallow powder.
13 |
14 |
15 |
16 | *These words are emphasized*
17 | _Also these words are emphasized_
18 |
19 | **These words are strong emphasized**
20 | __Also these words are strong emphasized__
21 |
22 |
23 | > This is a very simple blockquote
24 |
25 |
26 |
27 | * This
28 | * is
29 | * an
30 | * unordered
31 | * list.
32 |
33 | And...
34 |
35 | 1. This
36 | 2. is
37 | 3. an
38 | 4. ordered
39 | 5. list.
40 |
41 |
42 |
43 | [This is an example link](http://example.com/).
44 | [This is an example link with a title](http://example.com/ "¡Buenos días!").
45 |
46 |
47 |
48 | This is a image
49 | 
50 |
51 |
52 |
53 | `this is a line of code`
54 |
55 | And these are several lines of code. Pudding sesame snaps cupcake bonbon cupcake. Icing macaroon donut.
56 |
57 | More code. Donut cheesecake chocolate cake. Tart pudding wafer dessert chocolate bar jelly-o apple pie dessert. Carrot cake apple pie pie liquorice oat cake lollipop pastry caramels. Jelly-o sesame snaps gummi bears.
58 |
59 | And more. Sugar plum lemon drops chupa chups chocolate pastry. Faworki applicake applicake brownie topping liquorice chocolate liquorice icing. Cake pudding pudding cake candy sugar plum soufflé.`
60 |
61 |
62 | ```js
63 | var Remarkable = require('remarkable');
64 | var hljs = require('highlight.js') // https://highlightjs.org/
65 |
66 | // Actual default values
67 | var md = new Remarkable({
68 | highlight: function (str, language) {
69 | if (language && hljs.getLanguage(language)) {
70 | try {
71 | return hljs.highlight(str, { language }).value;
72 | } catch (err) {}
73 | }
74 |
75 | try {
76 | return hljs.highlightAuto(str).value;
77 | } catch (err) {}
78 |
79 | return ''; // use external default escaping
80 | }
81 | });
82 | ```
83 |
84 |
85 | And that's all ...
86 | This is an **extremely simple and basic** guide. To understand a lot better this kind of dark magic called markdown, logically I recommend the official wiki of the creator. Go, run, jump to [the site of John Gruber](http://daringfireball.net/projects/markdown/).
87 |
--------------------------------------------------------------------------------
/html5bp/doc/faq.md:
--------------------------------------------------------------------------------
1 | [HTML5 Boilerplate homepage](http://html5boilerplate.com) | [Documentation
2 | table of contents](TOC.md)
3 |
4 | # Frequently asked questions
5 |
6 | ### Why is the URL for jQuery without "http"?
7 |
8 | This is an intentional use of [protocol-relative
9 | URLs](http://paulirish.com/2010/the-protocol-relative-url/)
10 |
11 | **N.B.** Using a protocol-relative URL for files that exist on a CDN is
12 | problematic when you try to view your local files directly in the browser. The
13 | browser will attempt to fetch the file from your local file system. We
14 | recommend that you use a local server to test your pages (or Dropbox). This can
15 | be done using Python 2.x by running `python -m SimpleHTTPServer` or Python 3.x
16 | with `python -m http.server` from your local directory, using Ruby by installing
17 | and running [asdf](https://rubygems.org/gems/asdf), and by installing any one of
18 | XAMPP, MAMP, or WAMP.
19 |
20 | ### Why don't you automatically load the latest version of jQuery from the Google CDN?
21 |
22 | 1. The latest version of jQuery may not be compatible with the existing
23 | plugins/code on the site. Version updating should be an intentional
24 | decision.
25 | 2. The latest version has a very short `max-age=3600` compares to the specific
26 | version of `max-age=31536000`, which means you won't get the benefits of
27 | long-term caching.
28 |
29 |
30 | ### Why is the Google Analytics code at the bottom? Google recommends it be placed the `head`.
31 |
32 | The advantage to placing it in the `head` is that you will track a user's
33 | pageview even if they leave the page before it has been fully loaded. However,
34 | putting the code at the bottom keeps all the scripts together and reinforces
35 | that scripts at the bottom are the right move.
36 |
37 |
38 | ### How can I integrate [Twitter Bootstrap](http://twitter.github.com/bootstrap/) with HTML5 Boilerplate?
39 |
40 | You can use [Initializr](http://initializr.com) to create a custom build that
41 | includes HTML5 Boilerplate with Twitter Bootstrap.
42 |
43 | Read more about how [HTML5 Boilerplate and Twitter Bootstrap complement each
44 | other](http://www.quora.com/Is-Bootstrap-a-complement-OR-an-alternative-to-HTML5-Boilerplate-or-viceversa/answer/Nicolas-Gallagher).
45 |
46 |
47 | ### How do I prevent phone numbers looking twice as large and having a Skype highlight?
48 |
49 | If this is occurring, it is because a user has the Skype browser extension
50 | installed.
51 |
52 | Use the following CSS to prevent Skype from formatting the numbers on your
53 | page:
54 |
55 | ```css
56 | span.skype_pnh_container {
57 | display: none !important;
58 | }
59 |
60 | span.skype_pnh_print_container {
61 | display: inline !important;
62 | }
63 | ```
64 |
65 |
66 | ### Do I need to upgrade my sites each time a new version of HTML5 Boilerplate is released?
67 |
68 | No. You don't normally replace the foundations of a house once it has been
69 | built. There is nothing stopping you from trying to work in the latest changes
70 | but you'll have to assess the costs/benefits of doing so.
71 |
72 |
73 | ### Where can I get help for support questions?
74 |
75 | Please ask for help on
76 | [StackOverflow](http://stackoverflow.com/questions/tagged/html5boilerplate).
77 |
--------------------------------------------------------------------------------
/html5bp/doc/usage.md:
--------------------------------------------------------------------------------
1 | [HTML5 Boilerplate homepage](http://html5boilerplate.com) | [Documentation
2 | table of contents](TOC.md)
3 |
4 | # Usage
5 |
6 | Once you have cloned or downloaded HTML5 Boilerplate, creating a site or app
7 | usually involves the following:
8 |
9 | 1. Set up the basic structure of the site.
10 | 2. Add some content, style, and functionality.
11 | 3. Run your site locally to see how it looks.
12 | 4. (Optionally run a build script to automate the optimization of your site -
13 | e.g. [ant build script](https://github.com/h5bp/ant-build-script) or [node
14 | build script](https://github.com/h5bp/node-build-script)).
15 | 5. Deploy your site.
16 |
17 |
18 | ## Basic structure
19 |
20 | A basic HTML5 Boilerplate site initially looks something like this:
21 |
22 | ```
23 | .
24 | ├── css
25 | │ ├── main.css
26 | │ └── normalize.css
27 | ├── doc
28 | ├── img
29 | ├── js
30 | │ ├── main.js
31 | │ ├── plugins.js
32 | │ └── vendor
33 | │ ├── jquery.min.js
34 | │ └── modernizr.min.js
35 | ├── .htaccess
36 | ├── 404.html
37 | ├── apple-touch-icon-precomposed.png
38 | ├── index.html
39 | ├── humans.txt
40 | ├── robots.txt
41 | ├── crossdomain.xml
42 | └── favicon.ico
43 | ```
44 |
45 | What follows is a general overview of each major part and how to use them.
46 |
47 | ### css
48 |
49 | This directory should contain all your project's CSS files. It includes some
50 | initial CSS to help get you started from a solid foundation. [About the
51 | CSS](css.md).
52 |
53 | ### doc
54 |
55 | This directory contains all the HTML5 Boilerplate documentation. You can use it
56 | as the location and basis for your own project's documentation.
57 |
58 | ### js
59 |
60 | This directory should contain all your project's JS files. Libraries, plugins,
61 | and custom code can all be included here. It includes some initial JS to help
62 | get you started. [About the JavaScript](js.md).
63 |
64 | ### .htaccess
65 |
66 | The default web server configs are for Apache. For more information, please
67 | refer to the [Apache Server Configs
68 | documentation](https://github.com/h5bp/server-configs-apache/tree/master/doc).
69 |
70 | Host your site on a server other than Apache? You're likely to find the
71 | corresponding server configs project listed in our [Server Configs
72 | ](https://github.com/h5bp/server-configs/blob/master/README.md) repository.
73 |
74 | ### 404.html
75 |
76 | A helpful custom 404 to get you started.
77 |
78 | ### index.html
79 |
80 | This is the default HTML skeleton that should form the basis of all pages on
81 | your site. If you are using a server-side templating framework, then you will
82 | need to integrate this starting HTML with your setup.
83 |
84 | Make sure that you update the URLs for the referenced CSS and JavaScript if you
85 | modify the directory structure at all.
86 |
87 | If you are using Google Analytics, make sure that you edit the corresponding
88 | snippet at the bottom to include your analytics ID.
89 |
90 | ### humans.txt
91 |
92 | Edit this file to include the team that worked on your site/app, and the
93 | technology powering it.
94 |
95 | ### robots.txt
96 |
97 | Edit this file to include any pages you need hidden from search engines.
98 |
99 | ### crossdomain.xml
100 |
101 | A template for working with cross-domain requests. [About
102 | crossdomain.xml](crossdomain.md).
103 |
104 | ### Icons
105 |
106 | Replace the default `favicon.ico` and Apple Touch Icon with your own.
107 |
108 | If you want to use different Apple Touch Icons for different resolutions please
109 | refer to the [according documentation](extend.md#apple-touch-icons).
110 |
111 | You might want to check out Hans' handy [HTML5 Boilerplate Favicon and Apple
112 | Touch Icon
113 | PSD-Template](http://drublic.de/blog/html5-boilerplate-favicons-psd-template/).
114 |
--------------------------------------------------------------------------------
/html5bp/404.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | Page Not Found :(
6 |
141 |
142 |
143 |
144 |
Not found :(
145 |
Sorry, but the page you were trying to view does not exist.
146 |
It looks like this was the result of either:
147 |
148 | - a mistyped address
149 | - an out-of-date link
150 |
151 |
154 |
155 |