1
0
Fork 0
mirror of https://github.com/lise-henry/crowbook synced 2024-05-26 12:06:12 +02:00
crowbook/docs/book/html/chapter_000.html
2019-07-18 21:59:11 +02:00

335 lines
24 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="generator" content="crowbook">
<meta name="author" content="Élisabeth Henry">
<meta name="viewport" content="width=device-width">
<link rel = "icon" href = "images/image_1.svg">
<title>Crowbook User Guide - 1. Crowbook</title>
<link rel = "stylesheet" href = "stylesheet.css" type = "text/css"
/>
<link rel = "stylesheet" href = "print.css" type = "text/css"
media = "print" />
<script>
function on(name) {
var elements = document.getElementsByClassName(name);
for (var i = 0; i < elements.length; i++) {
var elem = elements[i];
elem.style.backgroundColor = "pink";
}
}
function off(name) {
var elements = document.getElementsByClassName(name);
for (var i = 0; i < elements.length; i++) {
var elem = elements[i];
elem.style.backgroundColor = "white";
}
}
var display_menu = false;
function toggle() {
if (display_menu == true) {
display_menu = false;
document.getElementById("nav").style.left = "-21%";
document.getElementById("content").style.marginLeft = "0%";
document.getElementById("menu").style.left = "1em";
/* if(document.getElementById("top")) {
document.getElementById("top").style.left = "0";
}
if(document.getElementById("footer")) {
document.getElementById("footer").style.marginLeft = "0%";
}*/
} else {
display_menu = true;
document.getElementById("nav").style.left = "0";
document.getElementById("content").style.marginLeft = "20%";
document.getElementById("menu").style.left = "20%";
/* if(document.getElementById("top")) {
document.getElementById("top").style.left = "20%";
}
if(document.getElementById("footer")) {
document.getElementById("footer").style.marginLeft = "20%";
}*/
}
}
</script>
</head>
<body>
<script type = 'application/ld+json'>
{
"@context": "http://schema.org/",
"@type": "Book",
"author": "Élisabeth Henry",
"name": "Crowbook User Guide",
"version": "0.14.0",
"license": "This guide is published under the Creative Commons Attribution-ShareAlike 4.0-International license.",
"about": "Crowbook allows to render a book written in Markdown in various formats. This is some kind of manual for it, and a way to demonstrate and test it.",
"inLanguage": "en"
}
</script>
<nav id = "nav">
<h2><a href = "index.html">Crowbook User Guide</a></h2>
<ul>
<li><a href="chapter_000.html#link-1">1. Crowbook</a>
<ul><li><a href="chapter_000.html#link-2">1.1. Example</a></li>
<li><a href="chapter_000.html#link-3">1.2. Installing</a></li>
<li><a href="chapter_000.html#link-6">1.3. Dependencies</a></li>
<li><a href="chapter_000.html#link-7">1.4. Quick tour</a></li>
<li><a href="chapter_000.html#link-8">1.5. Current features</a></li>
<li><a href="chapter_000.html#link-18">1.6. Contributors</a></li>
<li><a href="chapter_000.html#link-19">1.7. Acknowledgements</a></li>
<li><a href="chapter_000.html#link-20">1.8. ChangeLog</a></li>
<li><a href="chapter_000.html#link-21">1.9. Contributing</a></li>
<li><a href="chapter_000.html#link-22">1.10. Library</a></li>
<li><a href="chapter_000.html#link-23">1.11. License</a></li>
</ul>
</li>
<li><a href="chapter_001.html#link-24">2. Arguments</a>
<ul><li><a href="chapter_001.html#link-25">2.1. <code>--create</code></a></li>
<li><a href="chapter_001.html#link-26">2.2. <code>--single</code></a></li>
<li><a href="chapter_001.html#link-27">2.3. <code>--set</code></a></li>
<li><a href="chapter_001.html#link-28">2.4. <code>--list-options</code></a></li>
<li><a href="chapter_001.html#link-29">2.5. <code>--print-template</code></a></li>
<li><a href="chapter_001.html#link-30">2.6. <code>--stats</code></a></li>
<li><a href="chapter_001.html#link-31">2.7. <code>--proofread</code></a></li>
<li><a href="chapter_001.html#link-32">2.8. <code>--autograph</code></a></li>
<li><a href="chapter_001.html#link-34">2.9. <code>--verbose</code></a></li>
<li><a href="chapter_001.html#link-35">2.10. <code>--to</code></a></li>
<li><a href="chapter_001.html#link-37">2.11. <code>--output</code></a></li>
<li><a href="chapter_001.html#link-38">2.12. <code>--lang</code></a></li>
</ul>
</li>
<li><a href="chapter_002.html#link-40">3. The configuration file</a>
<ul><li><a href="chapter_002.html#link-41">3.1. Configuration in an inline YAML block</a></li>
<li><a href="chapter_002.html#link-42">3.2. The list of files</a></li>
<li><a href="chapter_002.html#link-45">3.3. Crowbook options</a></li>
<li><a href="chapter_002.html#link-60">3.4. Full list of options</a></li>
</ul>
</li>
<li><a href="chapter_003.html#link-77">4. Markdown format</a>
<ul><li><a href="chapter_003.html#link-78">4.1. Tables</a></li>
<li><a href="chapter_003.html#link-79">4.2. Footnotes</a></li>
<li><a href="chapter_003.html#link-80">4.3. Superscript and subscript</a></li>
<li><a href="chapter_003.html#link-81">4.4. “Standalone” images</a></li>
<li><a href="chapter_003.html#link-82">4.5. Interactive fiction</a></li>
</ul>
</li>
<li><a href="chapter_004.html#link-83">5. Templates</a>
<ul><li><a href="chapter_004.html#link-84">5.1. Create and edit template</a></li>
<li><a href="chapter_004.html#link-88">5.2. List of templates</a></li>
<li><a href="chapter_004.html#link-102">5.3. List of accessible variables</a></li>
</ul>
</li>
<li><a href="chapter_005.html#link-106">6. Proofreading with Crowbook</a>
<ul><li><a href="chapter_005.html#link-107">6.1. Enabling proofreading</a></li>
<li><a href="chapter_005.html#link-108">6.2. Repetition detection</a></li>
<li><a href="chapter_005.html#link-109">6.3. Grammar checking</a></li>
</ul>
</li>
<li><a href="chapter_006.html#link-112">7. Interactive fiction</a>
<ul><li><a href="chapter_006.html#link-113">7.1. Basics</a></li>
<li><a href="chapter_006.html#link-114">7.2. The interactive fiction renderer</a></li>
<li><a href="chapter_006.html#link-115">7.3. Using Javascript in your interactive fiction</a></li>
<li><a href="chapter_006.html#link-116">7.4. Embedding Makdown in your Javascript code embedded in your Markdown</a></li>
<li><a href="chapter_006.html#link-117">7.5. Conditional blocks</a></li>
<li><a href="chapter_006.html#link-118">7.6. Interactive fiction options</a></li>
</ul>
</li>
<li><a href="chapter_007.html#link-119">8. Tips and tricks</a>
<ul><li><a href="chapter_007.html#link-120">8.1. Using Crowbook with Emacs markdown mode</a></li>
<li><a href="chapter_007.html#link-122">8.2. Embedding fonts in an EPUB file</a></li>
</ul>
</li>
<li><a href="chapter_008.html#link-123">9. Contributing</a>
<ul><li><a href="chapter_008.html#link-124">9.1. Internationalization</a></li>
</ul>
</li>
<li><a href="chapter_009.html#link-125">ChangeLog</a>
<ul><li><a href="chapter_009.html#link-126">unreleased</a></li>
<li><a href="chapter_009.html#link-127">0.14.1 (2018-06-01)</a></li>
<li><a href="chapter_009.html#link-128">0.14.0 (2017-11-26)</a></li>
<li><a href="chapter_009.html#link-129">0.14.0-beta (2017-10-08)</a></li>
<li><a href="chapter_009.html#link-130">0.13.0 (2017-07-14)</a></li>
<li><a href="chapter_009.html#link-131">0.12.0 (2017-06-05)</a></li>
<li><a href="chapter_009.html#link-132">0.11.4 (2017-03-21)</a></li>
<li><a href="chapter_009.html#link-133">0.11.3 (2017-03-19)</a></li>
<li><a href="chapter_009.html#link-134">0.11.2 (2017-03-05)</a></li>
<li><a href="chapter_009.html#link-135">0.11.1 (2017-01-05)</a></li>
<li><a href="chapter_009.html#link-136">0.11.0 (2016-12-31)</a></li>
<li><a href="chapter_009.html#link-137">0.10.4 (2016-12-16)</a></li>
<li><a href="chapter_009.html#link-138">0.10.3 (2016-11-19)</a></li>
<li><a href="chapter_009.html#link-139">0.10.2 (2016-10-21)</a></li>
<li><a href="chapter_009.html#link-140">0.10.1 (2016-10-18)</a></li>
<li><a href="chapter_009.html#link-141">0.10.0 (2016-10-18)</a></li>
<li><a href="chapter_009.html#link-142">0.9.1 (2016-09-29)</a></li>
<li><a href="chapter_009.html#link-143">0.9.0 (2016-09-23)</a></li>
<li><a href="chapter_009.html#link-144">0.8.0 (2016-09-19)</a></li>
<li><a href="chapter_009.html#link-145">0.7.0 (2016-09-11)</a></li>
<li><a href="chapter_009.html#link-146">0.6.0 (2016-09-09)</a></li>
<li><a href="chapter_009.html#link-147">0.5.1 (2016-04-14)</a></li>
<li><a href="chapter_009.html#link-148">0.5.0 (2016-04-02)</a></li>
<li><a href="chapter_009.html#link-149">0.4.0 (2016-03-01)</a></li>
<li><a href="chapter_009.html#link-150">0.3.0 (2016-02-27)</a></li>
<li><a href="chapter_009.html#link-151">0.2.2 (2016-02-25)</a></li>
<li><a href="chapter_009.html#link-152">0.2.1 (2016-02-25)</a></li>
<li><a href="chapter_009.html#link-153">0.2.0 (2016-02-25)</a></li>
<li><a href="chapter_009.html#link-154">0.1.0 (2016-02-21)</a></li>
</ul>
</li>
<li><a href="chapter_010.html#link-155">GNU LESSER GENERAL PUBLIC LICENSE</a></li>
</ul>
</nav>
<div id = "content">
<div id = "top"><p id = "para-1278">Crowbook User Guide 0.14.0</p>
</div>
<div id = "page">
<header>
<div id = "menu">
<img id = "menu-button" onclick="toggle();"
src="menu.svg" alt = "Table of contents" title = "Table of contents" />
</div>
</header>
<h1 id = 'link-1'><span class = 'chapter-header'>Chapter 1</span><br />Crowbook</h1><p id = "para-1"><a href = "https://travis-ci.org/lise-henry/crowbook"><img src = "https://travis-ci.org/lise-henry/crowbook.svg?branch=master" title = "" alt = "Travis status" /></a> <a href = "https://ci.appveyor.com/project/lise-henry/crowbook"><img src = "https://ci.appveyor.com/api/projects/status/bnj1rg76khth0aia?svg=true" title = "" alt = "Appveyor status" /></a></p>
<p id = "para-2">Crowbooks aim is to allow you to write a book in Markdown without worrying about formatting or typography, and let the program generate HTML, PDF and EPUB output for you. Its focus is novels and fiction, and the default settings should (hopefully) generate readable books with correct typography without requiring you to worry about it.</p>
<h2 id = "link-2">1.1. Example</h2>
<p id = "para-3">To see what Crowbooks output looks like, you can read the Crowbook guide rendered in <a href = "http://lise-henry.github.io/crowbook/book/book.html">HTML</a>, <a href = "http://lise-henry.github.io/crowbook/book/book.pdf">PDF</a> or <a href = "http://lise-henry.github.io/crowbook/book/book.epub">EPUB</a>.</p>
<p id = "para-4">You can also play with the <a href = "http://vps.crowdagger.fr/crowbook/">online demo version</a>.</p>
<h2 id = "link-3">1.2. Installing</h2>
<p id = "para-5">There are two ways to install Crowbook: either using precompiled binaries, or compiling it using <code>cargo</code>.</p>
<h3 id = "link-4">Binaries</h3>
<p id = "para-6">See <a href = "https://github.com/lise-henry/crowbook/releases">the releases page</a> to download a precompiled binary for your architecture (currently: Linux, Windows and MacOSX). Just extract the archive and run <code>crowbook</code> (or <code>crowbook.exe</code> on Windows). You might also want to copy the binary somewhere in your <code>PATH</code> for later usage.</p>
<p id = "para-7">If you are on Debian GNU/Linux or Ubuntu (on a PC architecture), you can also download <code>.deb</code> packages on <a href = "https://github.com/lise-henry/crowbook/releases">the releases page</a>.</p>
<h3 id = "link-5">Using Cargo</h3>
<p id = "para-8"><a href = "https://crates.io/">Cargo</a> is the <a href = "https://www.rust-lang.org/">Rust</a>s package manager. You can <a href = "https://www.rust-lang.org/downloads.html">install it here</a>. Once it is done:</p>
<pre><span style="color:#b58900;">$</span><span style="color:#839496;"> cargo install crowbook
</span></pre><p id = "para-9">will automatically download the latest <code>crowbook</code> release on <a href = "https://crates.io/crates/crowbook">crates.io</a>, compile it, and install it on your system.</p>
<blockquote><p id = "para-10">Some dependencies also require building C libraries; you might thus also need to install a C compiler and <code>make</code>/<code>cmake</code> build tools. You can also try to build a version of Crowbook without optional features: <code>cargo install crowbook --no-default-features --features "clap"</code> will disable syntactic highlighting and proofreading, requiring less dependencies.</p>
</blockquote>
<h2 id = "link-6">1.3. Dependencies</h2>
<p id = "para-11">While there should be, strictly speaking, no real dependencies to be able to run Crowbook (it is published as a statically compiled binary), some features require additional commands to work correctly:</p>
<ul>
<li><p id = "para-12">EPUB rendering requires the <code>zip</code> command to be present on your system;</p>
</li>
<li><p id = "para-13">PDF rendering requires a working installation of LaTeX (preferably <code>xelatex</code>).</p>
</li>
</ul>
<h2 id = "link-7">1.4. Quick tour</h2>
<p id = "para-14">The simplest command is:</p>
<pre><span style="color:#b58900;">$</span><span style="color:#839496;"> crowbook </span><span style="color:#657b83;">&lt;</span><span style="color:#839496;">BOOK</span><span style="color:#657b83;">&gt;
</span></pre><p id = "para-15">where <code>BOOK</code> is a configuration file. Crowbook will parse this file and generate HTML, EPUB, and/or PDF output formats, according to the settings in the configuration file.</p>
<p id = "para-16">To create a new book, assuming you have a list of Markdown files, you can generate a template configuration file with the <code>--create</code> argument:</p>
<pre><span style="color:#b58900;">$</span><span style="color:#839496;"> crowbook my.book</span><span style="color:#268bd2;"> --create</span><span style="color:#839496;"> chapter_</span><span style="color:#859900;">*</span><span style="color:#839496;">.md
</span></pre><p id = "para-17">This will generate a default <code>my.book</code> file, which youll need to complete. This configuration file contains some metadata, options, and lists the Markdown files.</p>
<p id = "para-18">For short books containing only a single Markdown file, it is possible to embed some metadata at the beginning of the file and use the <code>--single</code> or <code>-s</code> option to run <code>crowbook</code> directly on this Markdown file and avoid creating a separate book configuration file:</p>
<pre><span style="color:#b58900;">$</span><span style="color:#839496;"> crowbook</span><span style="color:#268bd2;"> -s</span><span style="color:#839496;"> text.md
</span></pre><p id = "para-19">For more information, see the chapters on <a href = "chapter_001.html">the arguments supported by <code>crowbook</code></a> and on <a href = "chapter_002.html">the configuration file</a>.</p>
<h2 id = "link-8">1.5. Current features</h2>
<h3 id = "link-9">Output formats</h3>
<p id = "para-20">Crowbook supports HTML, PDF and EPUB (either version 2 or 3) as output formats. See the Crowbook User Guide rendered in <a href = "http://lise-henry.github.io/crowbook/book/book.html">HTML</a>, <a href = "http://lise-henry.github.io/crowbook/book/book.epub">EPUB</a> and <a href = "http://lise-henry.github.io/crowbook/book.pdf">PDF</a>.</p>
<h3 id = "link-10">Input format</h3>
<p id = "para-21">Crowbook uses <a href = "https://crates.io/crates/pulldown-cmark">pulldown-cmark</a> and thus should support most of <a href = "http://commonmark.org/">CommonMark Markdown</a>. Inline HTML, however, is not implemented, and probably wont be, as the goal is to have books that can also be generated in PDF (and maybe ODT).</p>
<h3 id = "link-11">Typographic “cleaning”</h3>
<p id = "para-22">Maybe the most specific “feature” of Crowbook is that it does its best to “clean” the input text before rendering it. By default, it removes superfluous spaces and tries to use curly quotes. If the books language is set to french, it also tries to respect french typography by replacing spaces with non-breaking ones when it is appropriate (e.g. before ?, !, ; or :).</p>
<blockquote><p id = "para-23">Please <a href = "https://github.com/lise-henry/crowbook/issues/new">open an issue</a> describing typographic rules if you want them to be implemented for other languages.</p>
</blockquote>
<h3 id = "link-12">Links handling</h3>
<p id = "para-24">Crowbook tries to correctly translate local links in the input Markdown files: e.g. if you have a link to a Markdown file that is part of your book, it will be transformed into a link inside the document.</p>
<h3 id = "link-13">Inline YAML blocks</h3>
<p id = "para-25">Crowbook supports inline YAML blocks:</p>
<pre><span style="color:#839496;">---
</span><span style="color:#268bd2;">author</span><span style="color:#839496;">: </span><span style="color:#268bd2;">Me
title</span><span style="color:#839496;">: </span><span style="color:#2aa198;">My title
</span><span style="color:#839496;">---
</span></pre><p id = "para-26">This is mostly useful when Crowbook is run with the <code>--single</code> argument (receiving a single Markdown file instead of a book configuration file), for short texts that only contain one “chapter”.</p>
<h3 id = "link-14">Proofreading</h3>
<p id = "para-27">Crowbook can also generate “proofreading” copies in HTML or PDF, highlighting grammar errors and repetitions. For more information, see <a href = "chapter_005.html">the proofreading chapter of the guide</a>.</p>
<h3 id = "link-15">Interactive fiction</h3>
<p id = "para-28">Crowbook has experimental support for writing interactive fiction (only for HTML). For more information, read the <a href = "chapter_006.html">interactive fiction chapter</a>.</p>
<h3 id = "link-16">Customization</h3>
<p id = "para-29">While the default settings will hopefully generate something that should look “good enough”, it is possible to customize the output, essentially by providing different <a href = "chapter_004.html">templates</a>.</p>
<h3 id = "link-17">Bugs</h3>
<p id = "para-30">See the <a href = "https://github.com/lise-henry/crowbook/issues">githubs issue tracker</a>.</p>
<h2 id = "link-18">1.6. Contributors</h2>
<ul>
<li><p id = "para-31"><a href = "http://stephanemourey.fr/">Stéphane Mourey</a> <code>&lt;s+crowbook AT stephanemourey DOT fr&gt;</code></p>
</li>
<li><p id = "para-32"><a href = "https://github.com/hirschenberger">Falco Hirschenberger</a></p>
</li>
</ul>
<h2 id = "link-19">1.7. Acknowledgements</h2>
<p id = "para-33">Besides the <a href = "https://www.rust-lang.org/">Rust</a> compiler and standard library, Crowbook uses the following libraries: <a href = "https://crates.io/crates/pulldown-cmark">pulldown-cmark</a>, <a href = "https://crates.io/crates/yaml-rust">yaml-rust</a>, <a href = "https://crates.io/crates/mustache">mustache</a>, <a href = "https://github.com/kbknapp/clap-rs">clap</a>, <a href = "https://crates.io/crates/chrono">chrono</a>, <a href = "https://crates.io/crates/uuid">uuid</a>, <a href = "https://crates.io/crates/mime_guess">mime_guess</a>, <a href = "https://crates.io/crates/crossbeam">crossbeam</a>, <a href = "https://crates.io/crates/walkdir">walkdir</a>, <a href = "https://crates.io/crates/rustc-serialize">rustc-serialize</a>, <a href = "https://crates.io/crates/caribon">caribon</a>, <a href = "https://crates.io/crates/hyper">hyper</a>, <a href = "https://crates.io/crates/url">url</a>, <a href = "https://crates.io/crates/lazy_static">lazy_static</a>, <a href = "https://crates.io/crates/regex">regex</a>, <a href = "https://crates.io/crates/term">term</a>, <a href = "https://crates.io/crates/numerals">numerals</a>, <a href = "https://crates.io/crates/syntect">syntect</a>.</p>
<p id = "para-34">It can also embed <a href = "https://highlightjs.org/">Highlight.js</a> in HTML output to enable syntax highlighting for code blocks.</p>
<p id = "para-35">It also uses configuration files from <a href = "https://github.com/japaric/rust-everywhere">rust-everywhere</a> to use <a href = "https://travis-ci.org/">Travis</a> and <a href = "http://www.appveyor.com/">Appveyor</a> to generate binaries for various platforms on each release.</p>
<p id = "para-36">While Crowbook directly doesnt use them, there was also inspiration from <a href = "http://pandoc.org/">Pandoc</a> and <a href = "https://github.com/azerupi/mdBook">mdBook</a>.</p>
<p id = "para-37">Also, the <a href = "https://validator.w3.org/">W3C HTML validator</a> and the <a href = "http://validator.idpf.org/">IDPF EPUB validator</a> prove very useful during development and testing.</p>
<h2 id = "link-20">1.8. ChangeLog</h2>
<p id = "para-38">See <a href = "chapter_009.html">ChangeLog</a>.</p>
<h2 id = "link-21">1.9. Contributing</h2>
<p id = "para-39">See <a href = "chapter_008.html">how you can contribute to Crowbook</a>.</p>
<p id = "para-40">If you find this project useful, you can also support its author by <a href = "https://www.paypal.me/crowdagger">making a Paypal donation</a>.</p>
<h2 id = "link-22">1.10. Library</h2>
<p id = "para-41">While the main purpose of Crowbook is to be run as a standalone program, the code is written as a library, so if you want to build on it you can use it as such. You can look at the generated documentation on <a href = "https://docs.rs/releases/search?query=crowbook">docs.rs</a>.</p>
<p id = "para-42">Note that, in order to facilitate code reuse, some features have been split to separate libraries:</p>
<ul>
<li><p id = "para-43"><a href = "https://github.com/lise-henry/epub-builder">epub-builder</a> makes it easier to generate EPUB files.</p>
</li>
<li><p id = "para-44"><a href = "https://github.com/lise-henry/crowbook-text-processing/">crowbook-text-processing</a> contains all the “typographic” functions (smart quotes, handling of non-breaking spaces in french, ...).</p>
</li>
<li><p id = "para-45"><a href = "https://github.com/lise-henry/crowbook-intl/">crowbook-intl</a> is used for the internationalization (translation) process.</p>
</li>
</ul>
<h2 id = "link-23">1.11. License</h2>
<p id = "para-46">Crowbook is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License (LGPL), version 2.1 or (at your option) any ulterior version. See <a href = "chapter_010.html">LICENSE</a> for more information.</p>
<p id = "para-47">Crowbooks logo is licensed under the <a href = "https://creativecommons.org/licenses/by/4.0/deed.en">Creative Commons Attribution 4.0 International license</a>, based on the <a href = "https://commons.wikimedia.org/wiki/File:Rust_programming_language_black_logo.svg">Rust logo</a> by Mozilla Corporation.</p>
<p id = "para-48">Crowbook includes binary (minified) CSS and Javascript files from <a href = "https://highlightjs.org/">Highlight.js</a>, written by Ivan Sagalaev, licensed under the following terms:</p>
<blockquote><p id = "para-49">Copyright (c) 2006, Ivan Sagalaev</p>
<p id = "para-50">All rights reserved.</p>
<p id = "para-51">Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:</p>
<ul>
<li><p id = "para-52">Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.</p>
</li>
<li><p id = "para-53">Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.</p>
</li>
<li><p id = "para-54">Neither the name of highlight.js nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.</p>
</li>
</ul>
<p id = "para-55">THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</p>
</blockquote>
<p class = "next_chapter">
<a href = "chapter_001.html">
2. Arguments »
</a>
</p>
</div>
<footer id = "footer"><p id = "para-1277">Generated by <a href = "https://github.com/lise-henry/crowbook">Crowbook</a> 0.15.0-beta2</p>
</footer>
</div>
</body>
</html>