文件列表:

Cargo.lock (18398, 2022-08-21)
Cargo.toml (1028, 2022-08-21)
LICENSE (1092, 2022-08-21)
examples/ (0, 2022-08-21)
examples/java_gradle/ (0, 2022-08-21)
examples/java_gradle/Yarner.toml (791, 2022-08-21)
examples/java_gradle/gradle/ (0, 2022-08-21)
examples/java_gradle/gradle/gradle/ (0, 2022-08-21)
examples/java_gradle/gradle/gradle/wrapper/ (0, 2022-08-21)
examples/java_gradle/gradle/gradle/wrapper/gradle-wrapper.jar (58910, 2022-08-21)
examples/java_gradle/gradle/gradle/wrapper/gradle-wrapper.properties (202, 2022-08-21)
examples/java_gradle/gradle/gradlew (5770, 2022-08-21)
examples/java_gradle/gradle/gradlew.bat (2954, 2022-08-21)
examples/netlogo/ (0, 2022-08-21)
examples/netlogo/Yarner.toml (746, 2022-08-21)
examples/netlogo/nlogo/ (0, 2022-08-21)
examples/netlogo/nlogo/Model.nlogo (632, 2022-08-21)
examples/python/ (0, 2022-08-21)
examples/python/Yarner.toml (576, 2022-08-21)
examples/rust/ (0, 2022-08-21)
examples/rust/Cargo.toml.md (188, 2022-08-21)
examples/rust/Yarner.toml (568, 2022-08-21)
guide/ (0, 2022-08-21)
guide/book.toml (500, 2022-08-21)
guide/src/ (0, 2022-08-21)
guide/src/SUMMARY.md (1090, 2022-08-21)
guide/src/advanced/ (0, 2022-08-21)
... ...

# Yarner [](https://github.com/mlange-42/yarner/actions/workflows/tests.yml) [](https://github.com/mlange-42/yarner) [](https://crates.io/crates/yarner) [](https://mlange-42.github.io/yarner) [](https://github.com/mlange-42/yarner/blob/master/LICENSE) A language-independent [Literate Programming](https://en.wikipedia.org/wiki/Literate_programming) tool for Markdown. From Markdown documents written and structured for humans, Yarner extracts code blocks into compilable source code. It offers sufficient features and flexibility to be usable also for larger projects with numerous files and multiple languages. Yarner works with familiar syntax, which can be further customized to suit your needs exactly. See the [examples](examples) directory for full working examples using different programming languages. See the [**User Guide**](https://mlange-42.github.io/yarner/) for documentation. * [Features](#features) * [Installation](#installation) * [Getting started](#getting-started) * [Configuration](#configuration) * [Contributing](#contributing) * [Acknowledgements](#acknowledgements) ## Features * Macros and named code blocks * Multiple files, multiple entrypoints * File transclusions * Reverse mode * Custom plugins * ... See the [**User Guide**](https://mlange-42.github.io/yarner/) for a complete and detailed explanation of all features. ## Installation **Pre-compiled binaries** 1. Download the [latest binaries](https://github.com/mlange-42/yarner/releases) for your platform 2. Unzip somewhere 3. *Optional:* add the parent directory of the executable to your `PATH` environmental variable **Using `cargo`** In case you have [Rust](https://www.rust-lang.org/) installed, you can install with `cargo`: ```plaintext > cargo install yarner ``` ## Getting started To set up a new project, use the `init` sub-command. Run the following in your project's base directory: ```plaintext > yarner init ``` This creates a file `Yarner.toml` with default settings, and a file `README.md` as starting point for Literate Programming. The generated file already contains some content to get started with Yarner's basic features. For details, see the [User Guide](https://mlange-42.github.io/yarner/). To build the project (extract code and create documentation), simply run: ```plaintext > yarner ``` This creates two sub-directories, one containing the extracted code (a minimal but working Rust project), and another containing the final documentation. Note that the contents of these directories can then be treated as usual, i.e. compiling the code with the normal compiler, or rendering Markdown to HTML or PDF. ## Examples ### Macros Macros are what enables the literate program to be written in logical order for the human reader. Using Yarner, this is accomplished by naming the code blocks, and then referencing them later by "invoking" the macro. By default, macro invocations start with `// ==>` and end with a period `.`. Both of these sequences can be customized to suit your needs better. The only restriction with macro invocations is that they must be the only thing on the line. Here, we have an unnamed code block as entrypoint, and "draw" code from two other code blocks into the main function. These code blocks are named by their first line of code, starting with `//-`. ~~~markdown The program starts in the main function. It calculates something and prints the result: ```rust fn main() { // ==> Calculate something. // ==> Print the result. } ``` The calculation does the following: ```rust //- Calculate something let result = 100; ``` Printing the result looks like this: ```rust //- Print the result println!("{}", result); ``` ~~~ The rendered document looks like this:

The program starts in the main function. It calculates something and prints the result: ```rust fn main() { // ==> Calculate something. // ==> Print the result. } ``` The calculation does the following: ```rust //- Calculate something let result = 100; ``` Printing the result looks like this: ```rust //- Print the result println!("{}", result); ```

The generated code looks like this: ```rust fn main() { let result = 100; println!("{}", result); } ``` ### Entrypoints By default, the entrypoint of the program is always the unnamed code block. However, a code block name can be given in `Yarner.toml` or passed to Yarner on the command line. Then, instead of starting at the unnamed code block, it will start at the code block with this name. By naming code blocks with prefix `file:` followed by a relative path, multiple code files can be created from one source file. Each code block with the `file:` prefix is treated as a separate entry point. ~~~markdown ```rust //- file:src/lib.rs fn say_hello() { println!("Hello Literate Programmer!"); } ``` ~~~ [File transclusions and links](https://mlange-42.github.io/yarner/links-and-transclusions.html) are further features that allow for projects with multiple code, documentation and/or source files. ## Configuration Configuration is provided via a toml configuration file (default: `Yarner.toml`). A file with default configurations is generated through the `init` sub-command. See the user guide chapters [configuration](https://mlange-42.github.io/yarner/configuration.html) for details on individual settings. ## Contributing Please use the [Issues](https://github.com/mlange-42/yarner/issues) for bug reports and feature suggestions. For questions and general discussion, use the [Discussions](https://github.com/mlange-42/yarner/discussions). Pull requests are welcome! ## Acknowledgements This tool is derived from [foxfriends](https://github.com/foxfriends)' work [outline](https://github.com/foxfriends/outline).

近期下载者：

相关文件：

评论：[我要评论] [举报此文件]

收藏者：