#mdbook #author #render #book #ai-pocket-reference #aipr-header

bin+lib mdbook-ai-pocket-reference

mdbook preprocessor for the ai-pocket-reference project

2 releases

new 0.1.1 Feb 14, 2025
0.1.0 Feb 12, 2025

#464 in Text processing

Download history 233/week @ 2025-02-11

233 downloads per month

MIT license

27KB
416 lines

mdbook-ai-pocket-reference


Lint Test Docs Test Lib GitHub License GitHub Release docs.rs

A preprocessor for mdbook that creates chapter-level contributor sections featuring authors' GitHub profiles.

Installation

cargo install mdbook-ai-pocket-reference
  1. Download the src/bin/assets/mdbook-ai-pocket-reference.css and add to your book's root directory:

[!NOTE] If working with ai-pocket-reference collection, then this additional css file is already included, and so this step can be safely skipped.

Usage

  1. Add to your book.toml:
[preprocessor.ai-pocket-reference]
command = "mdbook-ai-pocket-reference"

[output.html]
additional-css = ["mdbook-ai-pocket-reference.css"]
  1. Add ai-pocket-reference header:
# Chapter Title

<!-- Default header -->
{{#aipr_header}}

<!-- Default header with colab -->
{{#aipr_header colab=nlp/lora.ipynb}}

<!-- Default header with colab and no reading time -->
{{#aipr_header colab=nlp/lora.ipynb,reading_time=false}}

The preprocessor will expand the helper to include the established header style for AI Pocket References.

Examples

# LoRA

{{#aipr_header colab=nlp/lora.ipynb}}

Low-rank adaptation (LoRA) is parameter-efficient fine-tuning (PEFT) introduced
by Hu, Edward J. et...

Will render as:

image

Dependencies

~12–24MB
~354K SLoC