CookBook

Angular CookBook is an Open Source Angular Knowledge Project built for and by the community.

You can edit existing pages via top right pen icon button and propose Pull Request without having to open vscode. For new article, just create a folder and a markdown file you can also follow instructions below to project locally

Table of Contents

• How to Install ?
  • Prerequisites
    • Rust
  • dependencies
• Builds
• Serve
• How to Contribute ?

How to Install ?

Prerequisites

For the installation of the project, you need to install and use a bash terminal. you can use git bash or cmder

Rust

The way to install rustup differs by platform:

• On Unix:

  curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

  in your shell, This downloads and runs rustup-init.sh

• On Windows download and run rustup-init.exe from here

---

For more information about installation of rustup, see the rustup documentation.

Dependencies

rustc = 1.71.0

cargo install mdbook

mdbook = "^0.4.35"

Install dependencies from Cargo.toml

cargo install --path .

cargo install mdbook-admonish

mdbook-admonish = "^1.13.1"

cargo install mdbook-i18n-helpers

mdbook-i18n-helpers = "^0.2.4"

i18n

• Run

  MDBOOK_OUTPUT='{"xgettext": {"pot-file": "messages.pot"}}' \ mdbook build -d po

or

MDBOOK_OUTPUT='{"xgettext": {"pot-file": "messages.pot"}}' mdbook build -d po

• Update existing po for fr

  msgmerge --update po/fr.po po/messages.pot

• Update existing po for en

  msgmerge --update po/en.po po/messages.pot

Builds

• Run build in fr

 MDBOOK_BOOK__LANGUAGE=fr mdbook build -d >book/fr

• Run build in en

 MDBOOK_BOOK__LANGUAGE=en mdbook build -d >book/en

Serve

• Run serve in fr

MDBOOK_BOOK__LANGUAGE=fr mdbook serve -d book/fr -p 3000

• Run serve in en

MDBOOK_BOOK__LANGUAGE=en mdbook serve -d book/en -p 3001

How to Contribute?