info_tfgrid/docs/mdbook_basics.md

Introduction to Mdbook and Hero Mdbook

Table of Contents

• Introduction
• Installation
  • MacOS or Linux
  • Windows
• Create a New Mdbook
• More Information

---

Introduction

We introduce Mdbook and Hero Mdbook.

Installation

MacOS or Linux

• Install Brew

  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  

• Install cargo

  brew install --cask cargo
  

• Install mdbook

  cargo install mdbook
  

Windows

• Install Chocolatey

  • To install Chocolatey on Windows, we follow the official Chocolatey website instructions.
  • Run PowerShell as Administrator
  • Check if Get-ExecutionPolicy is restricted

    • Get-ExecutionPolicy
      

    • If it is restricted, run the following command:

      • Set-ExecutionPolicy AllSigned
        

  • Install Chocolatey

    • Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
      

  • Note: You might need to restart PowerShell to use Chocolatey

• Install Mdbook

  • choco install mdbook
    

Create a New Mdbook

• Open a terminal
• Create a new directory

  mkdir -p mdbook_folder
  cd mdbook_folder
  

• Initialize an mdbook book

  mdbook init
  

• Create new sections with SUMMARY.md
• Populate the content in the ̀src folder

More Information

• Basics of Git and GitHub
• Basics of Gitea
• Basics of Docker
• Update an mdbook on a GitHub repo
• Deploy a Hero Mdbook on Docker
• Create a Hero Mdbook