这个doxygen插件比较简单，说白了就是一键生成工程文档，只需要执行下面这行命令就行了
bash
xmake doxygen
当然你也可以指定输出目录，可以工程源码目录：
bash
xmake doxygen -o /tmp/output project/src
继续阅读 »
源码
更新内容
此版本重构了90%的代码
新特性
增加task任务机制，可运行自定义任务脚本
实现plugin扩展机制，可以很方便扩展实现自定义插件，目前已实现的一些内置插件
增加project文件导出插件(目前已支持makefile的生成，后续会支持：vs, xcode等工程的生成)
增加hello xmake插件（插件demo）
增加doxygen文档生成插件
增加自定义宏脚本插件（支持动态宏记录、宏回放、匿名宏、批量导入、导出等功能）
增加更多的类库用于插件化开发
实现异常捕获机制，简化上层调用逻辑
增加多个option进行宏绑定，实现配置一个参数，就可以同时对多个配置进行生效
增加显示全局构建进度
继续阅读 »
MkDocs
MkDocs（官网、Github）是一款使用python开发的轻量级静态站点生成器，主要用于生成api文档，使用markdown撰写，使用yaml作为配置文件。
安装
首先需要安装python以及pip，然后使用pip即可安装MkDocs。
sudo apt-get install python
sudo apt-get install python-pip
sudo pip install mkdocs
安装完成之后，可以执行命令mkdocs --version查看所安装版本。
开始使用
执行以下命令新建一个工程。
mkdocs new demo
cd demo
生成的目录里结构如下：
p
继续阅读 »
Preamble
这里我把视觉模型谈谈，还没写完，从最重要的有价值的章节（我管它叫做MVS，如果喜欢篮球应该对MVP很了解吧）开始写的，后续还会写，不要因为里面有的只有标题就冲我扔臭鞋。
9.1 可视化格式化模型(Visual Formatting Model)
这章和接下来描述了可视化格式化模型（VFM）：用户代理如何在可视媒体上处理文档树.
在VFM中，每个在文档树中的元素参照盒子模型生成0个或多个盒子。这些盒子的布局由以下几方面掌控：
盒子的尺寸和类型
位置方案（普通流、float和绝对定位）
元素在文档树中的关系；
外部信息（比如viewport的尺寸、图片等实际尺寸等）
这章和接下来定义的属性适用于continu
继续阅读 »
TL;DR 对已发布到远程仓库的分支进行衍合操作(rebase)，会产生重复的提交记录，本文举例描述这个问题。
git merge 与 git rebase 命令都用来合并代码，如果不需要审查提交记录，两者都可以无脑操作，相互替换；如果要生成有条理的提交记录，前者会记录多条开发分支扰乱视线，因而推荐使用后者。但后者要是使用不当，会生成令人糊涂的提交记录。这点官方文档里有描述，但我嫌它所举例子有点牵强，所以自己举例说明。
继续阅读 »
概述
此版本主要增强了vs201x工程的生成，以及支持vs2017编译环境，并且针对archlinux提供更加方便的aur安装。
项目主页
查看文档
详细更新内容如下：
新特性
添加aur打包脚本，并支持用yaourt包管理器进行安装。
添加set_basename接口，便于定制化修改生成后的目标文件名
改进
支持vs2017编译环境
支持编译android版本的rust程序
增强vs201x工程生成插件，支持同时多模式、架构编译
Bugs修复
修复编译android程序，找不到系统头文件问题
修复检测选项行为不正确问题
#57: 修复代码文件权限到0644
构建演示
继续阅读 »
之前xmake默认编译windows目标，debug模式下采用的是-Z7编译选项，内置的调试符号信息到obj文件里面
但是这种方式按msdn的文档上说，是属于旧式的调试符号文件格式，所以为了考虑后续的兼容性，xmake修改了默认的调试符号生成规则，
改为默认启用pdb符号文件，并且pdb的方式更为常用。。
这个行为的修改，并不会影响到xmake.lua的设置，如果在这个文件中，设置了启用调试符号：
lua
set_symbols("debug")
那么，编译debug版本的目标时，就会自动生成pdb文件，以tbox为例：
bash
$ xmake f -m debug
$ xmake
编译完成后，会自动在build
继续阅读 »
痛点
从2013年开始，本人开始活跃于github，以前托管于sourceforge、svn spot和oschina的开源项目，陆续迁移到了github。此前，我一直使用的是wiki系统来维护相关开源项目的文档及下载等。那时，Markdown还没有现在这么流行，在sourceforge等网站，我几乎不放文档。但迁移到github后，将之前的wiki页面渐渐转成了Markdown页面。在迁移到github之后，我比较重视文档，源代码的修改，有可能需要更新文档。此前wiki网站因为访问太慢，空间也不是特别稳定，在今年终于决定放弃维护，转而使用github pages功能来托管这些项目文档。
github pages是一个静态空间，
继续阅读 »
最近兴趣所致翻译了一本英文的SVG教程，并将其托管在GitHub，部署于GitBook。为了给大家最直观的效果，献上教程部署地址：https://svg.brucewar.me。这也是我第一次翻译英文文档，也是我第一次使用GitBook部署电子书。教程虽然简单，但基本涉及了SVG的所有知识点。
喂喂喂，跑题了啊！
回到正题，因为部署电子书涉及的工具比较多，不必担心，我将按以下流程来各个击破：
本地生成电子书
托管GitHub
发布到GitBook
绑定自定义域名
本地生成电子书
GitBook官方提供了一个命令行工具（gitbook），可以使用git和markdown制作本地电子书并支持预览等功能。在安装这个命令行工具之前，
继续阅读 »