actions
/
mdBook
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

updates to the mdbook introduction

This commit is contained in:
josh rotenberg 2021-07-24 18:41:53 -07:00
parent 27faa54ae8
commit b85d5eb455
2 changed files with 33 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

49
guide/src/README.md
View File

@ -1,25 +1,40 @@
# mdBook # Introduction
**mdBook** is a command line tool and Rust crate to create books using Markdown **mdBook** is a command line tool and Rust crate to create books with Markdown. The output resembles tools like Gitbook,
(as by the [CommonMark](https://commonmark.org/) specification) files. It's very and is ideal for creating product or API documentation, tutorials, course materials or anything that requires a clean,
similar to Gitbook but written in [Rust](http://www.rust-lang.org). easily navigable and customizable presentation. mdBook is written in [Rust](https://www.rust-lang.org); its performance
and simplicity made it ideal for use as a tool to publish directly to hosted websites such
as [GitHub Pages](https://pages.github.com) via automation. This guide, in fact, serves as both the mdBook documenation
and a fine example of what mdBook produces.
What you are reading serves as an example of the output of mdBook and at the mdBook includes built in support for both preprocessing your Markdown and alternative renderers for producing formats
same time as a high-level documentation. other than HTML. These facilites also enable other functionality such as
validation. [Searching](https://crates.io/search?q=mdbook&sort=relevance) Rust's [crates.io](https://crates.io) is a
great way to discover more extensions.
mdBook is free and open source, you can find the source code on ## API Documentation
[GitHub](https://github.com/rust-lang/mdBook). Issues and feature
requests can be posted on the [GitHub issue
tracker](https://github.com/rust-lang/mdBook/issues).
## API docs In addition to the above features, mdBook also has a Rust [API](https://docs.rs/mdbook/*/mdbook/). This allows you to
write your own preprocessor or renderer, as well as incorporate mdBook features into other applications.
The [For Developers](for_developers) section of this guide contains more information and some examples.
Alongside this book you can also read the [API ## Markdown
docs](https://docs.rs/mdbook/*/mdbook/) generated by Rustdoc if you would like
to use mdBook as a crate or write a new renderer and need a more low-level mdBook's [parser](https://github.com/raphlinus/pulldown-cmark) adheres to the [CommonMark](https://commonmark.org/)
overview. specification. You can take a quick [tutorial](https://commonmark.org/help/tutorial/),
or [try out](https://spec.commonmark.org/dingus/) CommonMark in real time. For a more in-depth experience, check out the
[Markdown Guide](https://www.markdownguide.org).
## Contributing
mdBook is free and open source. You can find the source code on
[GitHub](https://github.com/rust-lang/mdBook) and issues and feature requests can be posted on
the [GitHub issue tracker](https://github.com/rust-lang/mdBook/issues). mdBook relies on the community to fix bugs and
add features: if you'd like to contribute, please read
the [CONTRIBUTING](https://github.com/rust-lang/mdBook/blob/master/CONTRIBUTING.md) guide and consider opening
a [pull request](https://github.com/rust-lang/mdBook/pulls).
## License ## License
mdBook, all the source code, is released under the [Mozilla Public License The mdBook source and documentation is released under
v2.0](https://www.mozilla.org/MPL/2.0/). the [Mozilla Public License v2.0](https://www.mozilla.org/MPL/2.0/).

2
guide/src/SUMMARY.md
View File

@ -1,6 +1,6 @@
# Summary # Summary
- [mdBook](README.md) - [Introduction](README.md)
- [Command Line Tool](cli/README.md) - [Command Line Tool](cli/README.md)
- [init](cli/init.md) - [init](cli/init.md)
- [build](cli/build.md) - [build](cli/build.md)