mirror of
https://github.com/lise-henry/crowbook
synced 2024-09-22 00:53:06 +02:00
updated README and BUGS
This commit is contained in:
parent
c127ce615a
commit
7ace55d73a
4
Bugs.md
4
Bugs.md
@ -1,9 +1,9 @@
|
|||||||
Bugs
|
Bugs
|
||||||
====
|
====
|
||||||
|
|
||||||
* html/epub: numbering is limited to first level
|
* html: no table of contents
|
||||||
* epub: no way to embed custom files to epub
|
* epub: no way to embed custom files to epub
|
||||||
* latex: no support for links and images
|
* latex: no support images
|
||||||
* odt: no support for... a lot of stuff, actually
|
* odt: no support for... a lot of stuff, actually
|
||||||
* config: can't handle multiline string, which is a problem for fields
|
* config: can't handle multiline string, which is a problem for fields
|
||||||
like "desscription"
|
like "desscription"
|
||||||
|
26
README.md
26
README.md
@ -118,14 +118,9 @@ you want to hurt your eyes.
|
|||||||
|
|
||||||
Crowbook uses
|
Crowbook uses
|
||||||
[pulldown-cmark](https://crates.io/crates/pulldown-cmark) and thus
|
[pulldown-cmark](https://crates.io/crates/pulldown-cmark) and thus
|
||||||
should support most of commonmark Markdown. There are, however, a few
|
should support most of commonmark Markdown. Inline HTML, however, is
|
||||||
features that that are not supported:
|
not implemented, and probably won't be, as the goal is to have books
|
||||||
|
that can also be generated in PDF (and maybe ODT).
|
||||||
* Tables and Footnotes are not yet implemented. Tables might be
|
|
||||||
implemented soon, but footnotes are a bit more tricky.
|
|
||||||
* HTML in markdown is not implemented, and probably won't be, as the
|
|
||||||
goal is to have books that can also be generated in PDF (and maybe
|
|
||||||
ODT).
|
|
||||||
|
|
||||||
Maybe the most specific "feature" of Crowbook is that (by default, it
|
Maybe the most specific "feature" of Crowbook is that (by default, it
|
||||||
can be deactivated) tries to "clean" the input files. By default this
|
can be deactivated) tries to "clean" the input files. By default this
|
||||||
@ -137,13 +132,6 @@ space before '?', '!', ';' or ':'). This feature is relatively limited
|
|||||||
at the moment, but I might try to add more options and support for
|
at the moment, but I might try to add more options and support for
|
||||||
more languages.
|
more languages.
|
||||||
|
|
||||||
### Table of Contents ###
|
|
||||||
|
|
||||||
Crowbook currently only supports a table of contents for first-level
|
|
||||||
headers (e.g. chapters). There is currently no option to integrate it
|
|
||||||
in the document, so it is only generated in the EPUB
|
|
||||||
format.
|
|
||||||
|
|
||||||
See also [Bugs](Bugs.md).
|
See also [Bugs](Bugs.md).
|
||||||
|
|
||||||
|
|
||||||
@ -160,6 +148,12 @@ parsing markdown)
|
|||||||
* [chrono](https://crates.io/crates/chrono) (date and time library)
|
* [chrono](https://crates.io/crates/chrono) (date and time library)
|
||||||
* [uuid](https://crates.io/crates/uuid) (to generate uuid)
|
* [uuid](https://crates.io/crates/uuid) (to generate uuid)
|
||||||
|
|
||||||
|
It also uses configuration files from
|
||||||
|
[[rust-everywhere]](https://github.com/japaric/rust-everywhere) to use
|
||||||
|
[[Travis]](https://travis-ci.org/) and
|
||||||
|
[[Appveyor]](http://www.appveyor.com/) to generate binaries for
|
||||||
|
various platforms on each release.
|
||||||
|
|
||||||
While Crowbook directly doesn't use them, there was also inspiration from [Pandoc](http://pandoc.org/) and [mdBook](https://github.com/azerupi/mdBook).
|
While Crowbook directly doesn't use them, there was also inspiration from [Pandoc](http://pandoc.org/) and [mdBook](https://github.com/azerupi/mdBook).
|
||||||
|
|
||||||
ChangeLog
|
ChangeLog
|
||||||
@ -182,3 +176,5 @@ Crowbook is free software: you can redistribute it and/or modify it
|
|||||||
under the terms of the GNU Lesser General Public License (LGPL),
|
under the terms of the GNU Lesser General Public License (LGPL),
|
||||||
version 2.1 or (at your option) any ulterior version. See
|
version 2.1 or (at your option) any ulterior version. See
|
||||||
[LICENSE](LICENSE.md) file for more information.
|
[LICENSE](LICENSE.md) file for more information.
|
||||||
|
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user