[Внешний интерфейс Xiaomuxue] GitBook создает онлайн-электронные книги и техническую документацию (gitbook + Markdown + node)

1. Введение

Адрес официального сайта:

https://www.gitbook.com/

вставьте сюда описание изображения
вставьте сюда описание изображения

1.1 Введение в инструмент

  • Что такое Гитбук?
    GitBook — это современная платформа документации, где команды могут документировать все, от продуктов до внутренних баз знаний и API. Помогите командам работать более эффективно, создав простую и мощную платформу для обмена знаниями. Создайте удобный продукт для совместной работы, который позволит каждому создавать, редактировать и делиться знаниями с помощью документов.

вставьте сюда описание изображения

1.2 Плата за использование

вставьте сюда описание изображения

2. Установка

вставьте сюда описание изображения

2.1 установить узел

Node.js — это кроссплатформенная среда выполнения JavaScript с открытым исходным кодом.

  • Адрес официального сайта:
https://nodejs.org/zh-cn
https://nodejs.cn/

вставьте сюда описание изображения

  • После установки так:
    вставьте сюда описание изображения

  • Используйте следующую команду, чтобы проверить, успешно ли установлен узел.

node -v
npm -v

Node.js — это кроссплатформенная среда выполнения JavaScript с открытым исходным кодом. Это популярный инструмент практически для любого типа проекта!

Node.js запускает движок JavaScript V8 (ядро Google Chrome) вне браузера. Это делает Node.js очень эффективным.

Приложения Node.js выполняются в одном процессе без создания нового потока для каждого запроса. Node.js предоставляет набор примитивов асинхронного ввода-вывода в своей стандартной библиотеке, чтобы предотвратить блокировку кода JavaScript, и, как правило, библиотеки в Node.js написаны с использованием неблокирующей парадигмы, что делает поведение блокировки ненормальным, а не нормальным.

Когда Node.js выполняет операцию ввода-вывода, например чтение из сети, доступ к базе данных или файловой системе, вместо того, чтобы блокировать потоки и тратить циклы ЦП на ожидание, Node.js возобновляет операцию, когда приходит ответ.

Это позволяет Node.js обрабатывать тысячи одновременных подключений с использованием одного сервера, не создавая бремени управления параллелизмом потоков (что может быть значительным источником ошибок).

  • Наиболее распространенным примером Hello World для Node.js является веб-сервер:
const http = require('http');

const hostname = '127.0.0.1';
const port = 3000;

const server = http.createServer((req, res) => {
    
    
  res.statusCode = 200;
  res.setHeader('Content-Type', 'text/plain');
  res.end('Hello World\n');
});

server.listen(port, hostname, () => {
    
    
  console.log(`Server running at http://${
      
      hostname}:${
      
      port}/`);
});

Чтобы запустить этот фрагмент, сохраните его как файл server.js и запустите node server.js в терминале.
вставьте сюда описание изображения
Сначала установите nvm, зачем устанавливать это? Это менеджер различных версий node.js, который может переключать версии в любое время.
Если вы столкнулись с такой ситуацией, вам нужно только изменить версию, чтобы решить ее, и вам не нужно разбираться с зависимостями или переустанавливать node.js.

# linux系统安装
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bash

# windows 安装包
https://github.com/coreybutler/nvm-windows/releases/download/1.1.7/nvm-setup.zip

2.2 установить гитбук

  • Установите gitbook-cli, затем инициализируйте gitbook.
# 切换node版本
nvm install v12.22.3
nvm use v12.22.3

# 配置国内加速镜像
npm config set registry https://registry.npm.taobao.org
npm install -g gitbook-cli

# 初始化gitbook 
gitbook init

вставьте сюда описание изображения

gitbook --version

вставьте сюда описание изображения

3. Тест

3.1 Редактирование документов

  • Локальные сгенерированные файлы выглядят следующим образом:
    вставьте сюда описание изображения
  • Измените файл SUMMARY.md:
# Summary

* [Introduction](README.md)
* [前言](readme.md)
* [第一章](part1/README.md)
    * [第一节](part1/1.md)
    * [第二节](part1/2.md)
    * [第三节](part1/3.md)
    * [第四节](part1/4.md)
* [第二章](part2/README.md)
* [第三章](part3/README.md)
* [第四章](part4/README.md)

вставьте сюда описание изображения

3.2 Скомпилируйте проект

  • составить документ
gitbook build

вставьте сюда описание изображения

3.3 Предварительный просмотр проекта

  • предварительный просмотр документа
gitbook serve

вставьте сюда описание изображения

  • Браузер отображает сервер документов следующим образом:

вставьте сюда описание изображения

вставьте сюда описание изображения

эпилог

如果您觉得该方法或代码有一点点用处,可以给作者点个赞,或打赏杯咖啡;╮( ̄▽ ̄)╭
如果您感觉方法或代码不咋地//(ㄒoㄒ)//,就在评论处留言,作者继续改进;о_О???
如果您需要相关功能的代码定制化开发,可以留言私信作者;(✿◡‿◡)
感谢各位大佬童鞋们的支持!(´ ▽´ )ノ (´ ▽´)! ! !

рекомендация

отblog.csdn.net/hhy321/article/details/132121970