不晓得大家有没有这样的需要:我的项目工程想规范化,有一些要害类的阐明文档;或者刚接手了一个不堪入目,没有正文的工程,每次找一些要害类的时候,总是靠记忆或者其余笔记去关上。
明天在梳理接手的工程时候,想让写一个ReadMe文档,并且能够跳转关上一些文件,比方某些要害类。先看成果:
这个成果很大地满足了我的需要。为了达到这个成果,须要具备2个知识点:
- Markdown语法: 不理解同学的能够百度下,不到10分钟你就能够成为一个Markdown入门选手
- 跳转文件链接的配置
Markdown配置与语法
- 装置Markdown插件:Preferences→Plugins->Marketplace→装置Markdown插件,重启Android Studio
- 在工程目录中适当的地位创立以”README.md”文件(以md结尾的Markdown文件即可)
- 复制上面这段md,按住Ctrl + 鼠标左键 or Command + 鼠标左键,即可跳转关上指定的文件,包含文件夹
[测试](build.gradle)
Markdown根底语法:
-
代表着题目,几个#代表这个几级的题目
[显示的文本](跳转的链接)
:中拓号用于显示预览的文本,括号内是链接地址,能够网址,也能够是本文中的文件地址
上文动图,能够参考自己GitHub工程
文件援用门路的生成
下面动图应用到的文件门路[app/src/main/java/com/ben/template/XApplication.kt],有肯定的规定:必须是从我的项目的根目录作为起始门路,而不是在电脑系统中的绝对路径。所以这里要应用一个命令:Path From Respository Root,能够通过以下2个形式去找到
- 菜单栏→Edit→Copy找到
- 设置项Preferences→Keymap→间接搜寻并增加快捷键
其余
- Markdown举荐编辑器:马克飞象 这个编辑器是我入坑Markdown以来始终在用的,渲染成果好,能够导出pdf、md、html。
- Android Studio上还能够通过Favorites面板来保留须要的文件,也能够通过书签Bookmarks来保留,有相应的快捷键
发表回复