1- # cargo-doc2readme ![ License: Apache-2.0] ( https://img.shields.io/badge/license-Apache--2.0-blue ) [ ![ cargo-doc2readme on crates.io] ( https://img.shields.io/crates/v/cargo-doc2readme )] ( https://crates.io/crates/cargo-doc2readme ) [ ![ Source Code Repository] ( https://img.shields.io/badge/Code-On%20GitHub-blue?logo=GitHub )] ( https://github.com/msrd0/cargo-doc2readme ) ![ Rust Version: 1.61.0] ( https://img.shields.io/badge/rustc-1.61.0-orange.svg )
1+ # This repository has moved to < https://codeberg.org/msrd0/cargo-doc2readme >
2+
3+ # cargo-doc2readme ![ License: Apache-2.0] ( https://img.shields.io/badge/license-Apache--2.0-blue ) [ ![ cargo-doc2readme on crates.io] ( https://img.shields.io/crates/v/cargo-doc2readme )] ( https://crates.io/crates/cargo-doc2readme ) [ ![ Source Code Repository] ( https://img.shields.io/badge/Code-On%20Codeberg-blue?logo=Codeberg )] ( https://codeberg.org/msrd0/cargo-doc2readme ) ![ Rust Version: 1.61.0] ( https://img.shields.io/badge/rustc-1.61.0-orange.svg )
24
35` cargo doc2readme ` is a cargo subcommand to create a readme file to display on
4- [ GitHub ] [ __link0 ] or [ crates.io] [ __link1 ] ,
6+ [ Codeberg ] [ __link0 ] , [ GitHub ] [ __link1 ] or [ crates.io] [ __link2 ] ,
57containing the rustdoc comments from your code.
68
79## Installation
@@ -14,7 +16,7 @@ yay -S cargo-doc2readme
1416
1517On other Operating Systems, make sure you have Rust installed (using your
1618distributions package manager, but if your package manager is garbage or you are
17- running Windows, try [ rustup] [ __link2 ] ) and then run the following command:
19+ running Windows, try [ rustup] [ __link3 ] ) and then run the following command:
1820
1921``` bash
2022cargo install cargo-doc2readme
@@ -31,14 +33,15 @@ cargo doc2readme
3133This will output the readme to a file called ` README.md ` , using ` README.j2 ` or the
3234built-in template.
3335
34- If you want to run this using GitHub Actions, you can use the pre-built docker image:
36+ If you want to run this using Forgejo or GitHub Actions, you can use the pre-built
37+ docker image:
3538
3639``` yaml
3740readme :
3841 runs-on : ubuntu-latest
3942 steps :
40- - uses : actions/checkout@v3
41- - uses : docker://ghcr.io /msrd0/cargo-doc2readme
43+ - uses : actions/checkout@v4
44+ - uses : docker://codeberg.org /msrd0/cargo-doc2readme
4245 with :
4346 entrypoint : cargo
4447 args : doc2readme --check
@@ -63,11 +66,16 @@ cargo doc2readme was created. If you need a newer/nightly Rust compiler, use the
6366
6467# # Similar tools
6568
66- [`cargo readme`][__link3 ] is a similar tool. However, it brings its own Rust code
69+ [`cargo readme`][__link4 ] is a similar tool. However, it brings its own Rust code
6770parser that only covers the 95% use case. Also, it does not support Rust path links
68- introduced in Rust 1.48, making your readme ugly due to GitHub showing the unsupported
69- links as raw markdown, and being less convenient for the reader that has to search
70- [docs.rs][__link4] instead of clicking on a link.
71+ introduced in Rust 1.48, making your readme ugly since the unsupported links are shown
72+ as raw markdown, and being less convenient for the reader that has to search [docs.rs][__link5]
73+ instead of clicking on a link.
74+
75+ [`cargo rdme`][__link6] is another tool which places your rustdoc into your readme.
76+ However, it does not come with template support, which is helpful for bigger repositories
77+ that contain multiple crates, and has only very basic support for Rust path links. All
78+ links not starting with `crate::` or `::std` are unsupported by `cargo rdme`.
7179
7280# # Stability Guarantees
7381
@@ -79,8 +87,10 @@ command-line arguments or to these stability guarantees. All other changes, incl
7987any changes to the Rust code, or bumping the MSRV, are not considered breaking changes.
8088
8189
82- [__link0] : https://github.com
83- [__link1] : https://crates.io
84- [__link2] : https://rustup.rs/
85- [__link3] : https://github.com/livioribeiro/cargo-readme
86- [__link4] : https://docs.rs
90+ [__link0] : https://codeberg.org
91+ [__link1] : https://github.com
92+ [__link2] : https://crates.io
93+ [__link3] : https://rustup.rs/
94+ [__link4] : https://github.com/webern/cargo-readme
95+ [__link5] : https://docs.rs
96+ [__link6] : https://github.com/orium/cargo-rdme
0 commit comments