如何用gitbook写文档并存到github上

author author     2023-05-06     132

关键词:

1. 安装npm,从网站 下载node.js源代码 https://nodejs.org/#download 

解压
./configure
make
make install

成功执行后,npm就被安装好了。

2. gitbook 安装

npm install -g gitbook-cli
gitbook -V

查看gitbook是否安装成功。


3 安装git

https://code.google.com/p/msysgit/downloads/list


4 生成sshkey

输入 ssh-keygen ,按enter,一直按enter 公钥生成在 C:\\Documents and Settings\\xxx\\.ssh 目录中,找到目录 ,里面有id_rsa.pub文件,用记事本打开,然后把里面的东西 全选复制。

并在github上配置sshkey


5 下载gitbookeditor并安装

 https://www.gitbook.com/editor/windows


6 github上新建一个项目

git@github.com:zimingforever/mygitbook.git

并把这个项目直接clone到gitbook的文件目录下面C:\\Users\\XXX\\GitBook\\Library\\Import\\mygitbook

初始化文件夹

echo # mygitbook >> README.md
git initgit add README.md
git commit -m "first commit"
git remote add origin git@github.com:zimingforever/mygitbook.git
git push -u origin master


7 打开gitbookeitor,FILE-》imoport 找到之前的clone的文件

左侧table of contents可以增加新的章节或者文章


8 gitbook editor打开后,book-editor confugration可以设置book.json文件


9 目录 book-repo setting可以设置远程的git地址,需要更改成http的地址https://github.com/zimingforever/mygitbook.git,然后设置对应的账号及密码


10 每次gitbook eidtor编辑完之后可以点击下右侧的sync按钮,相关的文件就会推到github上


11 使用gitbook命令生成对应的html文件

c:

cd C:\\Users\\xxx\\GitBook\\Library\\Import\\

gitbook build mygitbook


12 将生成好的html文件推到github上

c:

cd C:\\Users\\xxx\\GitBook\\Library\\Import\\mygitbook

git config --global credential.helper store

git add -A

git commit -m \'udpatebook\'

git push

start https://github.com/zimingforever/mygitbook/tree/master/_book


13 GITBOOK editor的使用界面



14 使用githubpage来打开对应的地址

http://htmlpreview.github.io/


15 生成地址为 http://htmlpreview.github.io/?https://github.com/zimingforever/mygitbook/blob/master/_book/index.html 直接访问即可


参考技术A word文档另存为.mht文件
打开的时候用word打开速度比较快 如果用ie就比较慢.
还可以编译成为.chm帮助文档 需要特殊工具 这个打开速度 文件大小等等都非常棒 就是初次制作可能难点

如何用word文档在博客里发表文章

目前大部分的博客作者在用Word写博客这件事情上都会遇到以下3个痛点:1.所有博客平台关闭了文档发布接口,用户无法使用Word,WindowsLiveWriter等工具来发布博客。使用Word写博客需要在第三方博客平台注册帐号,且需要第三方博... 查看详情

如何用git将项目代码上传到github

注册账户以及创建仓库 要想使用github第一步当然是注册github账号了。之后就可以创建仓库了(免费用户只能建公共仓库),CreateaNewRepository,填好名称后Create,之后会出现一些仓库的配置信息,这也是一个git的简单教程。步... 查看详情

sqlalchemy文档翻译

...为什么不直接翻译一下文档呢?于是顺手查了查怎么使用Gitbook,2333于是就在Github开了项目,然后导入了Gitbook,开始写。今天开始的,决定每天写一部分,争取早日完成。 Github链接:https://github.com/linux-wang/sqlalchemy-docs-CNGitboo... 查看详情

如何用vscode的git功能往github上传代码

参考技术Agithub上创建仓库只能用英文。中文会被-覆盖。在github上新建仓库,例如vsdemo在本机磁盘下新建一个文件夹,例如vs打开终端输入gitinit这样就初始化了一个本地仓库新建个文件例如readme.txt在终端中添加文件到远程仓库.gitadd... 查看详情

如何用命令将本地项目上传到git和ssh配置

嘛,就是将服务器上的网站和本地同步。首先是上传服务器上的网站到github仓库gitinitgitadd.gitcommit-m‘‘关联远程仓库,先去github上新建一个,newrepositorygitremoteaddorigin你的远程库地址同步合并gitpull--rebaseoriginmaster推送gitpush-uoriginm... 查看详情

如何用word发布wordpress博客

目前大部分的博客作者在用Word写博客这件事情上都会遇到以下3个痛点:1.所有博客平台关闭了文档发布接口,用户无法使用Word,WindowsLiveWriter等工具来发布博客。使用Word写博客需要在第三方博客平台注册帐号,且需要第三方博... 查看详情

52abp实战教程0.1--devops如何用vsts持续集成到github仓库!

工欲善其事,必先利其器。在开始正式的教程之前我们先来聊聊准备工作。管理工具会VSTS。代码管理会用GITHUB。服务器会用Azure。所有的东西都是利用现有服务。不会说自己从虚拟机开始玩。我们就专注于写代码。什么是VSTS?VS... 查看详情

如何用git命令行上传本地代码到github(代码片段)

如何用git命令行上传本地代码到github2016年09月19日16:10:36阅读数:9337注意:安装的前提条件是配置好git的相关环境或者安装好git.exe,此处不再重点提及    上传的步骤:(本文采用git命令界面进行操作)   &... 查看详情

如何用git将代码上传到github(代码片段)

如何用Git将代码上传到GitHub前言本文以windows为例教大家如何使用Git把代码上传到GitHub。下载工具前往官网(https://gitforwindows.org/)下载Git安装包。下载完成之后,一路点击“Next”就完成安装了。配置身份在桌面或者... 查看详情

如何用git将代码上传到github(代码片段)

如何用Git将代码上传到GitHub前言本文以windows为例教大家如何使用Git把代码上传到GitHub。下载工具前往官网(https://gitforwindows.org/)下载Git安装包。下载完成之后,一路点击“Next”就完成安装了。配置身份在桌面或者... 查看详情

如何用命令将本地项目上传到github

1、(先用cd命令进入项目文件夹)通过命令gitinit把这个目录变成git可以管理的仓库gitinit2、把文件添加到版本库中,使用命令gitadd.添加到暂存区里面去,不要忘记后面的小数点“.”,意为添加文件夹下的所有文件(*add和小数点... 查看详情

如何用markdown编辑器排版github个人项目创建

参考技术A1、我们可以利用Markdown可插入文本,代码块,图片,表格等。在此之前我们还需要熟悉Markdown语法,至于Markdown规范,此处就不赘述了,简书和度娘上有很多这方面的博客请大家自行搜索。(1)、首先打开Markdown编辑器,... 查看详情

如何用git命令行上传本地代码到github

 注意:安装的前提条件是配置好Git的相关环境或者安装好git.exe,此处不再重点提及    上传的步骤:    本文采用git命令界面进行操作,先执行以下两个命令,配置用户名和email【设置用戶名和e-mail地址。... 查看详情

如何用visualstudio2008写汇编程序?

如何用VisualStudio2008写汇编程序?最近在上夏季小学期,在学汇编语言,关于用什么编辑环境一直很纠结。很想找到一个比较好的IDE,但是试了几个像RadASM之类的,发现还不是很满意。于是,只能用UltraEdit或NotePad之类的文本编辑... 查看详情

如何用css写打印样式

打印样式打印样式就是针对网页被打印时设置给文档的样式,由于打印时是显示在纸上,跟屏幕还是有区别的,对于有打印需求的网页往往需要设置专门的打印样式来适配页面。@mediaprint声明自己是打印样式有两种方法:在css文... 查看详情

如何用golang写游戏加经验函数不出错

游戏中加经验的地方很多,很多人写的很乱,我把这个功能用比较简单且清晰的方法写了下来。代码如下:packagemainimport("fmt""log""github.com/emirpasic/gods/maps/treemap")funcmain() exp:=[]int 20, 30, 40, 50, 70, 300, 350, 560, 650, 1000, ex 查看详情

如何用python写exe程序

Win下发布应用起因今天实验室同学看到我的乞丐版二输入规则器,他挺感兴趣的,也想要玩玩,但是他没有装python的环境,总不能让他一直玩我电脑吧,所以想到了将程序打包成exe,直接运行!想法一出来,根本挡不住啊,说干... 查看详情

java基础|如何用javadoctool写规范正确的java注释

前言:如果在源代码中添加以专用的定界符/**开始的注释,那么可以很容易地生成一个具有专业水准的文档。注释应该放置在所描述特性的前面。注释以/**开始,并以*/结束。 文档注释:第一段:概要描述,通常用一句或者... 查看详情