{"id":24539905,"url":"https://github.com/administroot/abs-mdbook-transfer","last_synced_at":"2026-05-07T01:09:43.506Z","repository":{"id":190410481,"uuid":"681682673","full_name":"Administroot/ABS-mdbook-transfer","owner":"Administroot","description":"《进阶Bash脚本编程指南》第十版Mdbook本地部署转换器","archived":false,"fork":false,"pushed_at":"2023-09-01T05:24:02.000Z","size":38,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-16T04:42:49.598Z","etag":null,"topics":["markdown","python3","shell"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Administroot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-08-22T14:27:53.000Z","updated_at":"2023-09-01T05:24:07.000Z","dependencies_parsed_at":"2023-08-24T15:09:00.837Z","dependency_job_id":null,"html_url":"https://github.com/Administroot/ABS-mdbook-transfer","commit_stats":null,"previous_names":["administroot/abs-mdbook-transfer"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Administroot/ABS-mdbook-transfer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Administroot%2FABS-mdbook-transfer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Administroot%2FABS-mdbook-transfer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Administroot%2FABS-mdbook-transfer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Administroot%2FABS-mdbook-transfer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Administroot","download_url":"https://codeload.github.com/Administroot/ABS-mdbook-transfer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Administroot%2FABS-mdbook-transfer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260370411,"owners_count":22998830,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["markdown","python3","shell"],"created_at":"2025-01-22T17:16:50.360Z","updated_at":"2026-05-07T01:09:43.456Z","avatar_url":"https://github.com/Administroot.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ABS Mdbook本地部署转换器\n\n[![MIT License](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)[![GitBook](https://img.shields.io/badge/GitBook-read-blue)](https://linuxstory.gitbook.io/advanced-bash-scripting-guide-in-chinese/)\n\n\u003e 主体功能已完善，部分格式影响较大的正在逐一手动修复中\n\n**ABS-Mdbook-Converter**是基于[Mdbook](https://rust-lang.github.io/mdBook/)（源代码仓库部署方式为[Gitbook](https://www.gitbook.com/)）的项目[《Bash脚本进阶指南》第十次修订本中文版](https://github.com/LinuxStory/Advanced-Bash-Scripting-Guide-in-Chinese)（简称ABS）的\u003cem\u003e**本地部署**\u003c/em\u003e工具。\n\n本工具用于将Markdown格式由Gitbook转换为Mdbook，并快速启动本地Mdbook服务器。\n\n## 快速开始\n\n### 一、环境准备\n\n- Mdbook依赖[**Rust**编译环境](https://www.rust-lang.org/)\n\n- 建议[**Python3.6**](https://www.python.org/downloads/)以上解释器\n\n```shell\ngit clone https://github.com/Administroot/ABS-mdbook-transfer.git ABS-mdbook-transfer --recursive\ncd ABS-mdbook-transfer \u0026\u0026 pip install -r requirements.txt\n```\n\n### 二、启动ABS-Mdbook-Converter\n\n```shell\npython abs_mdbook_transfer.py\n```\n\n### 三、启动Mdbook\n\n在当前目录执行\n\n```shell\nmdbook serve\n```\n\n## 为什么需要ABS-Mdbook-Converter\n\n![note](http://tldp.org/LDP/abs/images/note.gif) 首先，网络条件允许的情况下建议\u003ccode\u003e*在线*\u003c/code\u003e学习。\n\n那对于\u003ccode\u003e*离线*\u003c/code\u003e版本来说：\n[原翻译项目](https://github.com/LinuxStory/Advanced-Bash-Scripting-Guide-in-Chinese)使用Gitbook作为在线文档工具。它拥有丰富的插件生态，有着良好的展示效果。但是存在若干难以克服的问题：\n\n1. 首要问题就是Gitbook已经终止了离线版的维护\n\n2. Gitbook相较别的在线文档工具启动速度极慢\n\n3. Gitbook以及[Nodejs](https://nodejs.org/)的版本兼容问题（当然，这可以用[Docker](https://docker.com)来解决。但是，国内[Dockerhub](https://hub.docker.com)域名被污染力，悲）\n\nMdbook能够避开以上的问题，可以作为\u003cem\u003e**本地部署**\u003c/em\u003e的首选项！但是，部分的Markdown语法并不兼容，且观感较差。\n\n于是，便有了该项目。如果您想要将[ABS](tldp.org/LDP/abs/html/)作为一本工具书、自查手册、操作指南等等。那么，本项目定能助你一臂之力！\n\n## 注记\n\n翻译作品位于[Gitbook](https://linuxstory.gitbook.io/advanced-bash-scripting-guide-in-chinese/)上，欢迎指正！\n\n也欢迎对Shell感兴趣的你参与到我们的[翻译项目](https://github.com/LinuxStory/Advanced-Bash-Scripting-Guide-in-Chinese)中来！\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadministroot%2Fabs-mdbook-transfer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadministroot%2Fabs-mdbook-transfer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadministroot%2Fabs-mdbook-transfer/lists"}