1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169
// Copyright (C) 2016 Élisabeth HENRY. // // This file is part of Crowbook. // // Crowbook is free software: you can redistribute it and/or modify // it under the terms of the GNU Lesser General Public License as published // by the Free Software Foundation, either version 2.1 of the License, or // (at your option) any later version. // // Crowbook is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU Lesser General Public License for more details. // // You should have received a copy of the GNU Lesser General Public License // along with Crowbook. If not, see <http://www.gnu.org/licenses/>. //! Note: this documentation is relative to `crowbook` *as a library*. //! For documentation regarding the *program* `crowbook`, see //! [the Github page](https://github.com/lise-henry/crowbook). //! //! # Book //! //! The central structure of Crowbook is `Book`, who coordinates everything. //! //! Its roles are: //! //! * reading a book configuration file and setting the book options accordingly //! * reading the chapters (written in Markdown) listed in this configuration file //! to `Parser`, get back an AST and store it in memory //! * call `HtmlRenderer`, `EpubRenderer`, `LatexRenderer` and/or `OdtRenderer` //! according to the book's parameters and generate the appopriate files. //! //! ## Example //! //! ```ignore //! use crowbook::{Book, InfoLevel}; //! // Reads configuration file "foo.book" (and set verbosity do default level) //! let mut book = Book::new_from_file("foo.book", InfoLevel::Info, &[]).unwrap(); //! // Render all formats according to this configuration file //! book.render_all().unwrap(); //! ``` //! //! This is basically the code for the `crowbook` binary (though it contains a //! bit more error handling, checking parameters from command line and so on). //! This is, however, not very interesting for a library usage. //! //! The `Book` structure, however, exposes its `chapter` fields, which contains //! a vector with an element by chapter. With it, you can access the Markdown //! for all chapters represented as an Abstact Syntax Tree (i.e., a vector of `Token`s). //! It is thus possible to create a new renderer (or manipulate this AST in other ways). //! //! # Parser //! //! It is also possible to directly use `Parser` to transform some markdown string or file //! to this AST: //! //! ``` //! use crowbook::{Parser,Token}; //! let mut parser = Parser::new(); //! let result = parser.parse("Some *valid* Markdown").unwrap(); //! assert_eq!(format!("{:?}", result), //! r#"[Paragraph([Str("Some "), Emphasis([Str("valid")]), Str(" Markdown")])]"#); //! ``` //! //! Of course, you probably want to do something else with this AST than display it. //! Let's assume you want to count the number of links in a document. //! //! ``` //! use crowbook::{Parser,Token}; //! fn count(ast: &[Token]) -> u32 { //! let mut n = 0; //! for token in ast { //! match *token { //! // It's a link, increase counter //! Token::Link(_,_,_) => n += 1, //! // It's not a link, let's count the number of links //! // inside of the inner element (if there is one) //! _ => { //! if let Some(sub_ast) = token.inner() { //! n += count(sub_ast); //! } //! } //! } //! } //! n //! } //! //! let md = "# Here's a [link](http://foo.bar) #\n And *another [one](http://foo.bar)* !"; //! //! let mut parser = Parser::new(); //! let ast = parser.parse(md).unwrap(); //! assert_eq!(count(&ast), 2); //! ``` extern crate pulldown_cmark as cmark; extern crate mustache; extern crate chrono; extern crate uuid; extern crate yaml_rust; extern crate mime_guess; extern crate walkdir; extern crate rustc_serialize; extern crate crossbeam; extern crate crowbook_text_processing; #[macro_use] extern crate lazy_static; #[cfg(feature = "proofread")] extern crate hyper; #[cfg(feature = "proofread")] extern crate url; #[cfg(feature = "proofread")] extern crate caribon; pub use parser::Parser; pub use book::Book; pub use bookoption::BookOption; pub use bookoptions::BookOptions; pub use html::HtmlRenderer; pub use epub::EpubRenderer; pub use latex::LatexRenderer; pub use odt::OdtRenderer; pub use error::{Result, Error, Source}; pub use token::Token; pub use token::Data; pub use number::Number; pub use resource_handler::ResourceHandler; pub use logger::{Logger, InfoLevel}; pub use html_dir::HtmlDirRenderer; pub use html_single::HtmlSingleRenderer; pub use renderer::Renderer; pub use localize_macros::set_lang; #[macro_use] pub mod localize_macros; #[macro_use] mod html; mod html_dir; mod error; mod book; mod epub; mod latex; mod odt; mod parser; mod token; mod cleaner; mod number; mod resource_handler; mod logger; mod bookoptions; mod lang; mod renderer; mod html_single; mod toc; mod zipper; mod templates; mod bookoption; #[cfg(feature = "proofread")] mod grammar_check; #[cfg(feature = "proofread")] mod text_view; #[cfg(test)] mod tests;