Struct Book 

pub struct Book {

    pub id: String,
    pub name: String,
    pub subtitle: Option<String>,
    pub version: u32,
    pub landing_text: String,
    pub nameplate_color: String,
    pub accent: String,
    pub book_texture: String,
    pub categories: Vec<BookCategory>,
    pub entries: Vec<BookEntry>,
    pub i18n: bool,
    pub layouts: Vec<RecipeLayout>,
    pub page_types: Vec<PageType>,
}

A guide book: what a .ybook file holds.

Fields

id: String

The item that opens it (the mod’s namespace if it has none).

name: String

subtitle: Option<String>

The nameplate’s second line when version is 0.

version: u32

The book’s edition: its nameplate says “1st Edition”, “2nd Edition”… (0: the subtitle instead).

landing_text: String

nameplate_color: String

The nameplate’s text color (rrggbb).

accent: String

The color {accent|terms} are shown in (#rrggbb).

book_texture: String

Its sheet (laid out as BOOK_PNG): ns:textures/x.png, or Yog’s.

categories: Vec<BookCategory>

entries: Vec<BookEntry>

i18n: bool

Its texts are translation keys, shown in the game’s language (the build turns it on when a text is a .yres text or a name).

layouts: Vec<RecipeLayout>

Recipe layouts of its own; the build adds the mod’s (.ydef recipe kinds and layouts).

page_types: Vec<PageType>

The mods’ own kinds of page its pages use; the build adds them (.yui components with book_page).

Implementations

impl Book

pub fn read( text: &str, resolver: &mut dyn Resolve, ) -> Result<Read<Book>, Errors>

Reads a .ybook (text), references and texts going through resolver: the book as the game shows it, and what it references.

impl Book

pub fn localized(&self, tr: impl Fn(&str) -> String) -> Book

This book with its texts run through tr — names, descriptions, landing text and every page’s title/text. With Book::i18n on, the texts are translation keys and the renderer shows localized(<current language>) (see BookRenderer::set_translator).

pub fn to_json(&self) -> String

The book as the JSON hosts and yog build pass around.

Trait Implementations

impl Clone for Book

fn clone(&self) -> Book

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Book

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for Book

fn default() -> Book

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Book

where Book: Default,

fn deserialize<__D>( __deserializer: __D, ) -> Result<Book, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Schema for Book

fn shape() -> Shape

What the format looks like.

fn read(v: &ValueRef<'_>, cx: &mut Reader<'_>) -> Option<Book>

Reads v. Problems go to cx at its current path; None when the value couldn’t be read (the problem is in cx).

fn write(&self) -> Value

The value, as the format writes it.

fn absent() -> Option<Self>

The value of a field that isn’t there — None: the field is required.

fn skip(&self) -> bool

Whether a struct leaves this field out when writing it.

impl Serialize for Book

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.