diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index bcafd746..e703b003 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -5,22 +5,22 @@ Welcome stranger! If you have come here to learn how to contribute to mdBook, we have some tips for you! First of all, don't hesitate to ask questions! -Use the [issue tracker](https://github.com/azerupi/mdBook/issues), no question is too simple. -If we don't respond in a couple of days, ping us @azerupi, @steveklabnik, @frewsxcv it might just be that we forgot. :wink: +Use the [issue tracker](https://github.com/rust-lang-nursery/mdBook/issues), no question is too simple. +If we don't respond in a couple of days, ping us @Michael-F-Bryan, @budziq, @steveklabnik, @frewsxcv it might just be that we forgot. :wink: ### Issues to work on Any issue is up for the grabbing, but if you are starting out, you might be interested in the -[E-Easy issues](https://github.com/azerupi/mdBook/issues?q=is%3Aopen+is%3Aissue+label%3AE-Easy). +[E-Easy issues](https://github.com/rust-lang-nursery/mdBook/issues?q=is%3Aopen+is%3Aissue+label%3AE-Easy). Those are issues that are considered more straightforward for beginners to Rust or the codebase itself. These issues can be a good launching pad for more involved issues. Easy tasks for a first time contribution include documentation improvements, new tests, examples, updating dependencies, etc. If you come from a web development background, you might be interested in issues related to web technologies tagged -[A-JavaScript](https://github.com/azerupi/mdBook/issues?q=is%3Aopen+is%3Aissue+label%3AA-JavaScript), -[A-Style](https://github.com/azerupi/mdBook/issues?q=is%3Aopen+is%3Aissue+label%3AA-Style), -[A-HTML](https://github.com/azerupi/mdBook/issues?q=is%3Aopen+is%3Aissue+label%3AA-HTML) or -[A-Mobile](https://github.com/azerupi/mdBook/issues?q=is%3Aopen+is%3Aissue+label%3AA-Mobile). +[A-JavaScript](https://github.com/rust-lang-nursery/mdBook/issues?q=is%3Aopen+is%3Aissue+label%3AA-JavaScript), +[A-Style](https://github.com/rust-lang-nursery/mdBook/issues?q=is%3Aopen+is%3Aissue+label%3AA-Style), +[A-HTML](https://github.com/rust-lang-nursery/mdBook/issues?q=is%3Aopen+is%3Aissue+label%3AA-HTML) or +[A-Mobile](https://github.com/rust-lang-nursery/mdBook/issues?q=is%3Aopen+is%3Aissue+label%3AA-Mobile). When you decide you want to work on a specific issue, ping us on that issue so that we can assign it to you. Again, do not hesitate to ask questions. We will gladly mentor anyone that want to tackle an issue. @@ -41,7 +41,7 @@ mdBook builds on stable Rust, if you want to build mdBook from source, here are 0. Clone this repository with git. ``` - git clone https://github.com/azerupi/mdBook.git + git clone https://github.com/rust-lang-nursery/mdBook.git ``` 0. Navigate into the newly created `mdBook` directory 0. Run `cargo build` @@ -55,7 +55,7 @@ mdBook doesn't use CSS directly but uses [Stylus](http://stylus-lang.com/), a CS When you want to change the style, it is important to not change the CSS directly because any manual modification to the CSS files will be overwritten when compiling the stylus files. Instead, you should make your changes directly in the -[stylus files](https://github.com/azerupi/mdBook/tree/master/src/theme/stylus) and regenerate the CSS. +[stylus files](https://github.com/rust-lang-nursery/mdBook/tree/master/src/theme/stylus) and regenerate the CSS. For this to work, you first need [Node and NPM](https://nodejs.org/en/) installed on your machine. Then run the following command to install both [stylus](http://stylus-lang.com/) and [nib](https://tj.github.io/nib/), you might need `sudo` to install successfully. diff --git a/Cargo.toml b/Cargo.toml index d47d8fe4..beea4abc 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -3,8 +3,8 @@ name = "mdbook" version = "0.0.26" authors = ["Mathieu David "] description = "create books from markdown files (like Gitbook)" -documentation = "http://azerupi.github.io/mdBook/index.html" -repository = "https://github.com/azerupi/mdBook" +documentation = "http://rust-lang-nursery.github.io/mdBook/index.html" +repository = "https://github.com/rust-lang-nursery/mdBook" keywords = ["book", "gitbook", "rustbook", "markdown"] license = "MPL-2.0" readme = "README.md" diff --git a/README.md b/README.md index 4976a3bf..352e66ff 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ Linux / OS X - + @@ -16,7 +16,7 @@ - + @@ -26,14 +26,14 @@ mdBook is a utility to create modern online books from Markdown files. ## What does it look like? -The [**Documentation**](http://rust-lang-nursery.github.io/mdBook/) for mdBook has been written in Markdown and is using mdBook to generate the online book-like website you can read. The documentation uses the latest version on GitHub and showcases the available features. +The [**User Guide**](https://rust-lang-nursery.github.io/mdBook/) for mdBook has been written in Markdown and is using mdBook to generate the online book-like website you can read. The documentation uses the latest version on GitHub and showcases the available features. ## Installation There are multiple ways to install mdBook. 1. **Binaries** - Binaries are available for download [here](https://github.com/azerupi/mdBook/releases). Make sure to put the path to the binary into your `PATH`. + Binaries are available for download [here](https://github.com/rust-lang-nursery/mdBook/releases). Make sure to put the path to the binary into your `PATH`. 2. **From Crates.io** This requires [Rust and Cargo](https://www.rust-lang.org/) to be installed. Once you have installed Rust, type the following in the terminal: @@ -55,7 +55,7 @@ There are multiple ways to install mdBook. The version published to crates.io will ever so slightly be behind the version hosted here on GitHub. If you need the latest version you can build the git version of mdBook yourself. Cargo makes this ***super easy***! ``` - cargo install --git https://github.com/azerupi/mdBook.git + cargo install --git https://github.com/rust-lang-nursery/mdBook.git ``` Again, make sure to add the Cargo bin directory to your `PATH`. @@ -63,7 +63,7 @@ There are multiple ways to install mdBook. If you want to contribute to mdBook you will have to clone the repository on your local machine: ``` - git clone https://github.com/azerupi/mdBook.git + git clone https://github.com/rust-lang-nursery/mdBook.git ``` `cd` into `mdBook/` and run @@ -79,7 +79,7 @@ There are multiple ways to install mdBook. mdBook will primarily be used as a command line tool, even though it exposes all its functionality as a Rust crate for integration in other projects. -Here are the main commands you will want to run. For a more exhaustive explanation, check out the [documentation](http://azerupi.github.io/mdBook/). +Here are the main commands you will want to run. For a more exhaustive explanation, check out the [User Guide](http://rust-lang-nursery.github.io/mdBook/). - `mdbook init` @@ -95,7 +95,7 @@ Here are the main commands you will want to run. For a more exhaustive explanati `book` and `src` are both directories. `src` contains the markdown files that will be used to render the output to the `book` directory. - Please, take a look at the [**Documentation**](http://azerupi.github.io/mdBook/cli/init.html) for more information and some neat tricks. + Please, take a look at the [**Documentation**](http://rust-lang-nursery.github.io/mdBook/cli/init.html) for more information and some neat tricks. - `mdbook build` @@ -113,13 +113,13 @@ Here are the main commands you will want to run. For a more exhaustive explanati Aside from the command line interface, this crate can also be used as a library. This means that you could integrate it in an existing project, like a web-app for example. Since the command line interface is just a wrapper around the library functionality, when you use this crate as a library you have full access to all the functionality of the command line interface with an easy to use API and more! -See the [Documentation](http://azerupi.github.io/mdBook/lib/lib.html) and the [API docs](http://azerupi.github.io/mdBook/mdbook/index.html) for more information. +See the [User Guide](https://rust-lang-nursery.github.io/mdBook/) and the [API docs](https://docs.rs/mdbook/*/mdbook/) for more information. ## Contributions Contributions are highly appreciated and encouraged! Don't hesitate to participate to discussions in the issues, propose new features and ask for help. -If you are just starting out with Rust, there are a series of issus that are tagged [E-Easy](https://github.com/azerupi/mdBook/issues?q=is%3Aopen+is%3Aissue+label%3AE-Easy) and **we will gladly mentor you** so that you can successfully go through the process of fixing a bug or adding a new feature! Let us know if you need any help. +If you are just starting out with Rust, there are a series of issus that are tagged [E-Easy](https://github.com/rust-lang-nursery/mdBook/issues?q=is%3Aopen+is%3Aissue+label%3AE-Easy) and **we will gladly mentor you** so that you can successfully go through the process of fixing a bug or adding a new feature! Let us know if you need any help. For more info about contributing, check out our [contribution guide](CONTRIBUTING.md) who helps you go through the build and contribution process! diff --git a/book-example/src/README.md b/book-example/src/README.md index 86b3dda7..823ea4eb 100644 --- a/book-example/src/README.md +++ b/book-example/src/README.md @@ -4,12 +4,11 @@ What you are reading serves as an example of the output of mdBook and at the same time as a high-level documentation. -mdBook is free and open source, you can find the source code on [Github](https://github.com/azerupi/mdBook). Issues and feature requests can be posted on the [Github Issue tracker](https://github.com/azerupi/mdBook/issues). +mdBook is free and open source, you can find the source code on [Github](https://github.com/rust-lang-nursery/mdBook). Issues and feature requests can be posted on the [Github Issue tracker](https://github.com/rust-lang-nursery/mdBook/issues). ## API docs -Alongside this book you can also read the [API docs](mdbook/index.html) generated by Rustdoc if you would like -to use mdBook as a crate or write a new renderer and need a more low-level overview. +Alongside this book you can also read the [API 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 overview. ## License diff --git a/book-example/src/cli/cli-tool.md b/book-example/src/cli/cli-tool.md index 81ce85d6..bbd7964c 100644 --- a/book-example/src/cli/cli-tool.md +++ b/book-example/src/cli/cli-tool.md @@ -24,10 +24,10 @@ Run `mdbook help` in your terminal to verify if it works. Congratulations, you h ### Install Git version -The **[git version](https://github.com/azerupi/mdBook)** contains all the latest bug-fixes and features, that will be released in the next version on **Crates.io**, if you can't wait until the next release. You can build the git version yourself. Open your terminal and navigate to the directory of you choice. We need to clone the git repository and then build it with Cargo. +The **[git version](https://github.com/rust-lang-nursery/mdBook)** contains all the latest bug-fixes and features, that will be released in the next version on **Crates.io**, if you can't wait until the next release. You can build the git version yourself. Open your terminal and navigate to the directory of you choice. We need to clone the git repository and then build it with Cargo. ```bash -git clone --depth=1 https://github.com/azerupi/mdBook.git +git clone --depth=1 https://github.com/rust-lang-nursery/mdBook.git cd mdBook cargo build --release ``` diff --git a/book-example/src/cli/serve.md b/book-example/src/cli/serve.md index e4578c99..fc72d152 100644 --- a/book-example/src/cli/serve.md +++ b/book-example/src/cli/serve.md @@ -37,4 +37,4 @@ The `--dest-dir` (`-d`) option allows you to change the output directory for you ----- -***note:*** *the `serve` command has not gotten a lot of testing yet, there could be some rough edges. If you discover a problem, please report it [on Github](https://github.com/azerupi/mdBook/issues)* +***note:*** *the `serve` command has not gotten a lot of testing yet, there could be some rough edges. If you discover a problem, please report it [on Github](https://github.com/rust-lang-nursery/mdBook/issues)* diff --git a/book-example/src/cli/watch.md b/book-example/src/cli/watch.md index 8b110476..65fa86b3 100644 --- a/book-example/src/cli/watch.md +++ b/book-example/src/cli/watch.md @@ -23,4 +23,4 @@ The `--dest-dir` (`-d`) option allows you to change the output directory for you ----- -***note:*** *the `watch` command has not gotten a lot of testing yet, there could be some rough edges. If you discover a problem, please report it [on Github](https://github.com/azerupi/mdBook/issues)* +***note:*** *the `watch` command has not gotten a lot of testing yet, there could be some rough edges. If you discover a problem, please report it [on Github](https://github.com/rust-lang-nursery/mdBook/issues)* diff --git a/book-example/src/format/theme/index-hbs.md b/book-example/src/format/theme/index-hbs.md index d2d75fa1..33b05dc9 100644 --- a/book-example/src/format/theme/index-hbs.md +++ b/book-example/src/format/theme/index-hbs.md @@ -87,5 +87,5 @@ In addition to the properties you can access, there are some handlebars helpers ------ -*If you would like me to expose other properties or helpers, please [create a new issue](https://github.com/azerupi/mdBook/issues) +*If you would like me to expose other properties or helpers, please [create a new issue](https://github.com/rust-lang-nursery/mdBook/issues) and I will consider it.* diff --git a/book-example/src/format/theme/syntax-highlighting.md b/book-example/src/format/theme/syntax-highlighting.md index fe6b3654..bda56c35 100644 --- a/book-example/src/format/theme/syntax-highlighting.md +++ b/book-example/src/format/theme/syntax-highlighting.md @@ -53,7 +53,7 @@ Will render as ## Improve default theme If you think the default theme doesn't look quite right for a specific language, or could be improved. -Feel free to [submit a new issue](https://github.com/azerupi/mdBook/issues) explaining what you have in mind and I will take a look at it. +Feel free to [submit a new issue](https://github.com/rust-lang-nursery/mdBook/issues) explaining what you have in mind and I will take a look at it. You could also create a pull-request with the proposed improvements. diff --git a/ci/deploy.sh b/ci/deploy.sh index 84c5fb36..33021a60 100644 --- a/ci/deploy.sh +++ b/ci/deploy.sh @@ -28,7 +28,7 @@ git init git config user.name "Mathieu David" git config user.email "mathieudavid@mathieudavid.org" -git remote add upstream "https://$GH_TOKEN@github.com/azerupi/mdBook.git" +git remote add upstream "https://$GH_TOKEN@github.com/rust-lang-nursery/mdBook.git" git fetch upstream git reset upstream/gh-pages diff --git a/src/bin/mdbook.rs b/src/bin/mdbook.rs index 963189eb..53de436c 100644 --- a/src/bin/mdbook.rs +++ b/src/bin/mdbook.rs @@ -36,7 +36,7 @@ fn main() { .after_help("For more information about a specific command, \ try `mdbook --help`\n\ Source code for mdbook available \ - at: https://github.com/azerupi/mdBook") + at: https://github.com/rust-lang-nursery/mdBook") .subcommand(init::make_subcommand()) .subcommand(build::make_subcommand()) .subcommand(test::make_subcommand()); diff --git a/src/utils/fs.rs b/src/utils/fs.rs index af6f5354..ebbc6dad 100644 --- a/src/utils/fs.rs +++ b/src/utils/fs.rs @@ -44,8 +44,8 @@ pub fn file_to_string>(path: P) -> Result { /// /// **note:** it's not very fool-proof, if you find a situation where /// it doesn't return the correct path. -/// Consider [submitting a new issue](https://github.com/azerupi/mdBook/issues) -/// or a [pull-request](https://github.com/azerupi/mdBook/pulls) to improve it. +/// Consider [submitting a new issue](https://github.com/rust-lang-nursery/mdBook/issues) +/// or a [pull-request](https://github.com/rust-lang-nursery/mdBook/pulls) to improve it. pub fn path_to_root>(path: P) -> String { debug!("[fn]: path_to_root");