-
自动生成github README.md目录
2020-03-06 21:06:32文章目录0 写在前面1 解决方法 ...github上的READMEmd不能使用toc自动生成目录,于是谷歌搜索了一些github toc generater,并不好用。 1 解决方法 还是得上gh-md-toc这个神器,安装使用直接参考简书 ...0 写在前面
github上的READMEmd不能使用toc自动生成目录,于是谷歌搜索了一些github toc generater,并不好用。
1 解决方法
还是得上gh-md-toc这个神器,安装使用直接参考简书
-
VSCode自动生成github README.md目录
2020-04-06 13:08:01关于自动生成目录问题,之前本人搜集的博客提到的是gh-md-toc这个神奇,但是这个比较麻烦,不仅手动敲命令,还得复制粘贴,而VSCode比较方便。 需要下载Markdown All in One这个插件,光标点入md文档的开头,然后cmd...关于自动生成目录问题,之前本人搜集的博客提到的是gh-md-toc这个神奇,但是这个比较麻烦,不仅手动敲命令,还得复制粘贴,而VSCode比较方便。
需要下载Markdown All in One这个插件,光标点入md文档的开头,然后cmd(ctrl)+shift+p输入mardkown all in one找到create table of contents命令即可,这个生成目录的原理跟gh-md-toc类似,所以同样适用于github,但如果只是本地浏览目录直接使用```[TOC]``即可 -
md目录生成 & moveo_arduino联调步骤
2020-03-07 09:40:51目录 一 如何配置环境 1. 安装Arduino 2. 上传Arduino程序 二 如何使用 1. 前提 2. 启动 3. 连接 三 调试 一 如何配置环境 1. 安装Arduino 参考该文章进行安装Arduino 2. 上传Arduino程序 添加Accel...moveo_arduino联调步骤
目录生成地址 https://sleepeatcode.com/ghtoc
生成目录可置于码云(GITEE)目录
一 如何配置环境
1. 安装Arduino
- 参考该文章进行安装Arduino
2. 上传Arduino程序
- 添加AccelStepper-1.57库,在资源包里找到 moveo_moveit_arduino.ino 并编译上传
二 如何使用
1. 前提
开始前确保你已经将moveo的ros工作空间编译完成,参考链接
(以上文章默认使用适配melodic版本的gitee项目地址)2. 启动
- 使用以下命令启动带有Moveit插件的 RViz 界面
roslaunch moveo_moveit_config demo.launch
- 加载窗口后,在RViz的 MotionPlanning 面板中单击 Planning 选项卡,在左下角勾选 Allow Approximate IK Solutions 。
- 通过拖动交互式标记(末端执行器上的浅蓝色球)或在 Select Goal State 下选择一个新的目标状态。目标状态更新后, Plan and Execute 将仿真并执行从开始状态到更新的目标状态的轨迹。
至此,以及完成moveo机械臂的仿真,后面的命令将使仿真窗口里的机械臂与真实机械臂进行连接
3. 连接
在RViz已经运行的情况下,打开新的终端执行以下命令:
- 建立与Arduino通讯的rosserial节点
rosrun rosserial_python serial_node.py /dev/ttyACM0
上面的端口号可根据自己的情况进行修改,可通过Arduino界面进行查看
- 将仿真joint_state旋转转换为步进,并在Arduino脚本订阅的**/ joint_steps**主题上发布
rosrun moveo_moveit moveit_convert
- 发布末端角度示例
rostopic pub gripper_angle std_msgs/UInt16 <angle 0-180>
至此,在仿真中Plan and Execute的任何轨迹都会在真实的机器人上进行实现。
三 调试
-
在 moveo_moveit_arduino.ino 中更改机器人在RAMPS1.4引脚设置,然后上传到Arduino。
-
确保机器人和仿真在同一位置(将仿真与真实机械臂都设为垂直状态)
-
在 moveit_convert.cpp中,将stepsPerRevolution数组替换为每个电机的步数/转数(或微步数/转数)。(注意:如果您还不知道这些值,则可以使用MultiStepperTest.ino并记录/观察结果来实验性地获得电动机有多少微步/转)
-
进行完连接步骤之后,即创建好3个新的topic:
/joint_steps
:将每个电动机移至所需位置所需的步骤/joint_steps_feedback
:与**/joint_steps**相同,但由arduino发布,用以检查Arduino是否正确接收了信息/gripper_angle
:末端舵机的当前角度
-
使用
rostopic list
并检索主题 -
使用
rostopic echo /<topic>
查看关于<topic>
的数据 -
从命令行控制moveo移动:
rostopic pub joint_steps moveo_moveit/ArmJointState <Joint1 Joint2 Joint3 Joint4 Joint5 0>
- 更改“ Joint1,Joint2等” 为每个关节要移动的步数。
-
md目录问题文章1!!!!!!
2020-12-08 14:14:52利用amWiki轻松打造知识库或技术文档系统 1. 我为什么选择amWiki 1.1. 用什么来写? 1.2. 用什么系统? 1.3. amWiki的优点 1.4. amWiki的架构 ...2.4.2. MD文件命名规范 2.4.3. 再次生成文档 2.利用amWiki轻松打造知识库或技术文档系统
1. 我为什么选择amWiki
1.1. 用什么来写?
程序员写技术文档向来是个头大的事情。相信绝大部分人都有用Word写文档的经历。用Word写文档,的确是个万能的解决方案,但是你会花上大量的精力在排版上。我相信现在还有很多人不会用样式来排版。由于这些原因,最近几年Markdown格式(以下简称:MD)逐渐流行开来,使得人们在写文档时,不需要关心排版,直接书写,保证思路的流畅性。再加上MD格式被GitHub官方默认支持,使得MD开始大红大紫。
事实上,比MD格式出现更早的,还有一个叫“reStructuredText”的格式,简称“reST”,文件扩展名是rst。这是Python文档标准书写格式,所有的Python插件或者是库都是使用这个格式书写。它和MD格式一样,都是书写的时候不需要关心排版,但是reST比MD的功能强大很多,只不过支持的系统比较少。
1.2. 用什么系统?
如何有序的组织技术文档,也是一个头大的事情。市面上有大量的技术文档系统,或者是知识库系统。要么价格昂贵,要么做得不尽如人意。“GitHub Pages”的横空出世,让大家发现了一种新的技术文档系统的新的模式。你只需把MD文档按照简单的约定格式提交到git仓库里,系统会自动生成网页版本的文档。同样的,基于reST文档格式的,ReadTheDoc.org网站提供了类似的服务。
现在我们来看看市面上常见的知识库/技术文档系统
系统 特性 传统Wiki 语法晦涩难懂, 不支持树状分类,直接Pass GitHub Pages 网红一枚,但是不能本地搭建,只能在线托管 GitLab Pages GitLab是一个类似于GitHub的系统,可以搭建在自己的服务器上,很强大,但是搭建过程相当痛苦,巨复杂 ReadTheDoc.org 和GitHub Pages很像,但是支持reST,也是不能本地搭建,只能在线托管 gitbook 可以本地搭建,我更认为这是一个写书系统 Jira Confluence Jira大名鼎鼎,旗下Confluence也很强大,怎奈何一个“贵”!!不差钱的可以考虑 我们先来想一下我们梦想中的技术文档系统或者知识库系统是什么样子的。
- 价格便宜,免费的最好
- 能够轻松搭建
- 能够本地搭建,而不是托管(毕竟有些技术文档还是要保密的)
- 要有树状目录,最好支持多级目录(这个很重要,便于分类)
- 写文档迅速,不需要考虑排版,最好能够支持自动排版
- 支持流程图、函数等高级特性
- 支持代码自动排版和代码高亮(这是硬指标)
当我们找到amWiki的时候,我们发现它就是我们梦想中的系统
1.3. amWiki的优点
我们来看看官网上列举的amWiki特性
- 文档系统采用 markdown 语法
- 不用数据库,文档使用 .md 格式保存本地文件
- 无需服务端开发,只需支持 http 静态访问网页空间
- 一键创建新的文库
- 自动更新文库导航目录
- 支持多级目录
- 支持截图直接粘帖为本地 png 并插入当前 markdown
- 文档web端自适应显示,适合所有平台
- 支持接口文档自动抓取内容生成简单的ajax测试
- 无需服务端的全文库内容搜索与计分排序
看完这些,我们发现它已经超出我们的梦想了,实现很多很有意思的功能。
1.4. amWiki的架构
你可以使用VSCode或者ATOM来写MD文档。amWiki提供了VSCode和ATOM的插件,便于用户自动生成Html文档。你也可以把相关MD文件保存在版本库中。通过命令可以生成本地打开的html文件、HTTP服务器支持的文件、GitHub Pages支持的文件等三种类型。
2. 如何使用amWiki
2.1. 获取amWiki
amWiki是一个基于node.js的库,所以我们可以通过amwiki来安装。
node.js的包管理程序是npm,执行下面这行命令即可。- 安装node.js
- 执行命令
npm install -g amwiki
2.2. 如何开始一个新文库
创建一个自己的目录,并在当前目录下执行命令
amwiki -c
这样,amwiki会动态创建一批文件和文件夹
其中:- config.json:这个是核心的amwiki配置文件,必备!!
- library目录: 用于存放md文件的目录,必备!!
- amWiki目录:amWiki动态创建的js、css等文件,临时删除也可以
- index.html:amWiki动态创建的首页文件,临时删除也可以
2.3. amWiki的配置文件
amWiki的配置文件本身是个json文件
2.3.1. 常规配置
key value name 自定义文档系统名称,这个名称会显示在首页上 ver 自定义文档系统版本号,这个版本号会显示在首页上 logo 自定义首页左上角显示的logo page-mounts 如果是true,可以生成本地打开版本的html系统页面;false,则只生成在线打开的html系统页面 testing 设置为 true 的文库,文档满足一定条件将在右上角出现打开测试面板的按钮 注意:
如果文档时本地打开的话,不支持测试接口功能例:
{ "name": "xxx文档中心", "ver": "1.0", "logo": "http://xxx.com/logo.png", "page-mounts": false, "testing": true }
2.3.2. 其他配置项
key value colour 定义界面着色, 支持 # 开头的 6 位 16 进制 web 色、RGB 色两种模式 github-url github 项目地址。如果你的项目要放在github pages上,请设置 imports 页面嵌入自定义 css、js 文件 library-prefix 重新定义 library 路径,这点在企业级部署的时候倒是挺有用的 例:
{ "colour": "default", "github-url": "https://github.com/TevinLi/amWiki", "imports": [ "assets/test.css", "assets/test.js" ], "library-prefix": "/admin/dev-wiki" }
2.4. 有序的写Markdown文档
2.4.1. 文库目录结构
index.html // http 访问首页 amWiki/ // amWiki Web 端工作文件存放目录 library/ // 您的 markdown 文库目录,所有文件必须使用 .md 格式 ├ $navigation.md // amWiki 文库目录导航文件,可自动/手动更新 ├ home-首页.md // 内容区默认显示内容 ├ 01-关于amWiki文库/ // markdown 文件夹 01 │ ├ 001-关于amWiki // 一些 markdown 文档,支持更深目录 │ └ 002-... ├ 02-学习markdown/ // markdown 文件夹 02 │ ├ 001-md入门 │ └ 002-... └ 03-... // 更多 markdown 文件夹 config.json // 文库配置文件 (assetes/) // 如果您粘帖截图,图片文件将自动创建在此处
2.4.2. MD文件命名规范
- 任何一个library目录下的目录和文件,都应以数字开头用于排序
- 数字必须要么是整型要么是浮点数,且位数要一样(笔者试过,系统是按照字符串比大小的,而不是按照数值来比大小排序的)
- 数字后面紧跟减号
- 减号后面就是标题名称
2.4.3. 再次生成文档
当你每次更新好代码时,执行
amwiki -c
即可更新html文档
2.5. 使用本地模式直接浏览
1.开启本地模式, 在 config.json 上增加
{ "page-mounts": true }
2.重新创建文档
amwiki -c
3.打开index.html即可
amWiki强大在本地模式也可以搜索任意文档内容
2.6. 如何测试文档中约定的接口
2.6.1. 激活测试的条件
amWiki有个亮点功能就是“测试即服务”,可以直接测试文档中约定的接口。
当一篇文档中使用了 “请求地址”、“请求类型”、“请求参数” 三个字段作为 h3标题 并配套对应内容时,将激活接口测试功能
此时文档右上角将出现 “接口测试” 按钮,例如:
2.6.2. 接口测试的工作原理与步骤
- 当测试模块处于打开状态时,每次打开文档都会扫描文档转换 html 后的内容,满足三个 h3 时即开启测试功能
- 开启当前文档测试功能后,即会从页面上 抓取 符合一定格式的测试内容
- 格式化抓取的内容并生成可再次修改的表单
- 用户点击发送请求时,先并入全局参数到当前参数列表,再发送请求
- 收到请求结果,格式化显示
2.6.3. 接口测试文档的格式要求
2.6.3.1. 请求地址的格式
请求地址可以使用带 http 与不带 http 两种,下面两种写法都是合适的
/api/customer-flow http://localhost/api/customer-flow
注意,不带 http 将自动和当前域名拼合为完整绝对路径,而不是使用相对路径
2.6.3.2. 请求类型的格式
amWiki 暂时只支持 Get、Post、Put、Delete 四种普通 ajax 请求,不支持文件上传和其他高级方式通讯
2.6.3.3. 请求参数的格式
- 当接口不需要参数时,直接使用 “无” 即可
- 请求参数列表必须使用 表格,且必须按
参数名
、类型
、必填
、描述
、默认值
、参考值
的栏目顺序建立表格,否则不能正常抓取。
其中:
- 默认值与参考值同属参数的值,但是优先显示默认值,只有当没有默认值时参考值才有效,参考值是为了方便测试之用
- 参考值一栏可选,不写参考值的整个表格栏位,不会影响测试功能
3. 如何用Visual Studio Code来便捷书写Markdown文档
3.1. 为什么使用 VSCode
这个只是个人喜好,ATOM很笨重,因为是github出品的编辑器,有的时候插件都无法下载,大家懂得。而VSCode从系统资源占有率、运行速度上都优于ATOM,所以我个人推荐使用VSCode。
3.2. 使用amWiki插件
3.2.1. 安装
你需要搜索amWiki插件,并安装
3.2.2. 生成文档
在config.json上点击右键,可以看到菜单的第一项就是“基于当前config.json创建wiki”。只要点击即可创建。
这个菜单命令等价于命令:
amwiki -c
3.2.3. 辅助编辑MD文档
在任何一个打开的MD文档中点击右键,就可以看到有五个非常有用的选项
- 黏贴截图到文档:用来方便的插入基于链接的截图
- 插入页内目录:由于系统不支持TOC标签,插件提供了一个支持便捷插入页内目录的工具
- 更新页面挂载数据
- 导出项目为:github wiki
- 浏览当前页面
3.3. 利用插件更好的写Markdown
3.3.1. 安装插件
VSCode提供了很多的Markdown辅助插件,建议都安装
3.3.2. 强大的Markdown TOC插件
3.3.2.1. 为什么要讲这个插件?
因为Markdown有个重要的缺陷,就是不支持多级列表。而我们正常写官方文档的时候又习惯于使用多级列表给各级标题编号。如果没有多级列表,总觉得文档不正式。这个插件从另一个角度帮我们解决了这个问题。
3.3.2.2. 插入和更新多级列表
右键点击文档任何地方,我们都可以看到一个菜单
点击“Markdown Sections: insert/Update”命令,这个插件就会帮我们自动对“#”开头的标题创建或者更新多级标题
很赞吧~~~~。3.3.2.3. 生成多级列表的目录
点击右键菜单中的“Markdown TOC: insert/Update”命令,这个插件就会帮我们自动生成支持多级列表的目录
3.3.2.4. 每个人都会用到的特殊情况
一般的,amWiki会把一级标题(一个#开头的)作为文档的标题。我们也不希望把文档标题进行标号。我们希望从二级标题开始编号。这个时候我们只需要在生成目录的注释中,声明depthFrom:2。再执行上述两步即可
<!-- TOC depthFrom:2 -->
3.3.3. Markdown文档转换到其他格式
有的时候,我们还是会需要生成别的格式的文档,这个时候你需要安装pandoc插件,当然也要安装pandoc的安装包。
使用这个插件就可以支持将MD文档转成word、pdf等文档作者简介:陈建明,目前就职于agora声网。
-
vscode readme.md 目录结构_vscode的相对路径
2021-02-03 15:37:37vscode内调试路径默认为当前项目文件夹,例如如下结构:SPI_BINLOG_COMPARE/ 是根目录,执行文件放在子目录 bin/ 下,这会导致一个问题,就是当我们在 bin/ 目录内用 ../ 表示上级目录时,实际上定位的是 ... -
-
JS实用脚本1:在github文件夹中快速导出md目录
2021-03-30 01:32:35}``` 输出的内容一览 直接粘贴到 md 文件的效果如下, 能直接点击使用 093.JAVA拓展_XML文件.md 094.JAVA拓展_DOM4J的概述.md 原理解析 github 文件夹中的 a 标签在显示目录中都用的是这个 class 因此只需要抓取这... -
vscode readme.md 目录结构_【VSCode】插件开发——基础的基础
2021-01-31 19:45:11目录1. VSCode 插件能干啥?2. HelloWorld3. 核心目录结构4. 核心概念 4.1. Activation Events 4.2. Contribution Points4.3.VSCodeAPI1. VSCode 插件能干啥?Change the look of VS Code with a color or file icon... -
md生成目录
2019-12-09 16:43:43md文件生成目录 doctoc kkk.md cnpm -i doctoc -g -
md(目录)
2020-05-27 11:22:38这里写目录标题一级目录二级目录三级目录四级目录五级目录六级目录 一级目录 二级目录 三级目录 四级目录 五级目录 六级目录 -
你还在为生成Github README.md的目录发愁吗?
2020-05-28 13:30:44这个工具生成GitHub中README.md目录真的香!不用不知道,用起来就真香警告! -
github md文档目录生成
2018-06-08 03:08:36场景:生成下图的目录 ...README.md 复制到 gh-md-toc.exe 的根目录下 在该目录打开 powershell 窗口,打开方式:shift键 + 鼠标右键 输入命令 ./gh-md-toc.exe README.md 。 把下图红框的内容赋值到你的 RE... -
md5sum 目录
2013-01-22 10:11:39使用md5sum操作目录: find ./ -type f -print0 | xargs -0 md5sum > ./my.md5 检查也很简单: md5sum -c my.md5 -
md文件语法及目录使用
2017-04-17 14:34:55md文件 目录使用 -
md5目录下的文件包括子目录
2016-08-11 15:05:00find ./ -type f -print0 | xargs -0 md5sum -
md文件生成项目目录树
2020-07-05 22:14:59md文件生成项目目录树 1.安装mddir $ npm install mddir -g //全局安装 这种工具就是要全局安装 2.使用mddir 在当前想要生成的目录结构,直接使用mddir命令 $ mddir 结果会生成一个文件directoryList.md在当前项目... -
vue实现全局函数以及生成md文档目录和html文件
2020-01-01 01:40:06文章目录vue实现全局函数以及生成md文档目录和html文件vue中写全局函数新建一个log.js文件main.js中引用页面使用md说明文档 vue实现全局函数以及生成md文档目录和html文件 vue中写全局函数 业务介绍:在前面的文章... -
如何生成Github README.md文件目录
2020-12-21 09:58:48这里我们也不多分析了,直接上步骤。...将README.md文件复制到gh-md-toc.exe同级目录下 按住shift键同时右击,选择在此处打开powershell 在打开的命令窗口中输入 ./gh-md-toc.exe README.md 将以下内容复制 -
码云 Github README.md生成目录
2019-07-02 14:13:44标签来生成目录,由于我的文档目录过多,这种方式显然很不现实。所以在网上找到了如下的方式,这里先贴一下原帖地址。 https://www.jianshu.com/p/302abe331dcb windows的 gh-md-toc.exe地址:... -
php+取文件md5,PHP获取目录的md5值的函数
2021-03-25 10:55:00PHP获取目录的md5值的函数PHP#目录 #md5 #函数2012-05-10 20:47直接上代码:/*** 获取目录的 md5 序列值* @param string $dir 目录路径* @return string*/if ( ! function_exists('md5_folder')){function md5_... -
获取目录下所有文件MD5值
2015-08-23 10:01:55获取目录下所有文件MD5值,获取目录下所有文件MD5值. -
.md文件自动生成项目目录结构,预览.md文件
2019-08-26 11:06:42自动生成项目目录结构 1)安装mddir (-g是全局安装,可以选择不全局安装,...会有一个叫directoryList.md的文件,目录结构就在里面 我项目生成的目录结构长成这样: 记得要在目录结构的前后方都写上```,不然... -
MD——建立子目录
2011-01-09 13:13:001.功能:创建新的子目录 2.类型:内部命令 3.格式:MD[盘符:]/[路径名]/〈子目录名〉 4.使用说明: (1)“盘符... C:>MD FOX (在当前驱动器C盘下创建子目录FOX)<br -
md 生成目录 码云_DuangDuangDuang!码云项目的 Readme.md 特殊技能
2020-12-19 11:07:12码云项目的 Readme.md 特殊技能 我们在 码云 上创建新项目的时候,常常会看到默认使用 README 文件初始化该项目(如图1 所示),然后在新建项目的根目录下就会生成一个 README.md 文件(如图2 所示)。 图1 默认选中 ... -
可莱特QWL系列 MD LED工作灯产品目录.pdf
2019-09-17 21:17:03可莱特QWL系列 MD LED工作灯产品目录pdf,可莱特QWL系列 MD LED工作灯产品目录。 -
php+取文件md5,PHP 获取目录的 md5 序列值的方法
2021-03-25 10:55:50PHP 获取目录的 md5 序列值。代码:/*** 获取目录的 md5 序列值* @param string $dir 目录路径* @return string* @site www.jbxue.com*/if ( ! function_exists('md5_folder')){function md5_folder ($dir) {if (!is... -
为Github的README.md生成目录的小工具
2020-09-26 14:05:37java -jar toc.jar 1.md # 为1.md文件生成目录 java -jar toc.jar 1 # 为文件夹1内的.md生成目录 理论上JDK8也能跑,因为笔者用的是JDK 3 JAR包下载 Github 码云 CODE.CHINA 4 其他 其实生成的方法不只一种,下面...