随笔分类 -  文档撰写

OpenAPI初体验
摘要：问题的一开始源于客户和服务部门抱怨我的REST API文档写得不好，然后又了解到 django rest framework 利用 coreapi 能自动生成文档，再就是看到 swagger.io 上说得天花乱坠的，OpenAPI文档写完后，可以生成40种语言的客户端代码（用户都不用文档了，代码都生 阅读全文
posted @ 2018-05-25 16:36 windtail 阅读(15512) 评论(1) 推荐(0)
sphinx PDF 中文
摘要：使用reST撰写文档时，需要分多个文档时，就必须使用sphinx了，sphinx说起来很简单的，但是默认是不是支持中文的。幸好我出生的晚，sphinx现在已经支持xelatex了^_^ 安装 除了pandoc那篇文章里写到的要安装的东西，还需要安装如下软件包 操作 以上命令会在当前目录的 docs 阅读全文
posted @ 2018-01-15 19:02 windtail 阅读(2009) 评论(0) 推荐(0)
rst2pdf 中文
摘要：上篇说到用pandoc转换为reST为pdf是使用LaTeX作为中间格式的，而今天要说的rst2pdf貌似是直接转换为pdf的。 安装和调用 rst2pdf目前只支持Python2.7，因此在创建virtualenv时应使用-p选项指定2.7的python，即 最简单的调用方式是 然后默认就会生成x 阅读全文
posted @ 2018-01-12 13:49 windtail 阅读(2149) 评论(0) 推荐(1)
Pandoc PDF 中文
摘要：最近终于又决定（^_^）使用reStructuredText写文档了，输出PDF时的中文问题必须要解决下。 安装环境 非Debian或Windows请自行google之 LaTeX中文 这个PDF的中文问题，其实就是LaTeX的中文问题，因为所有的PDF生成方式，都是先生成TeX和LaTeX文件的。 阅读全文
posted @ 2018-01-10 18:36 windtail 阅读(2817) 评论(0) 推荐(0)
emacs 简记
摘要：简介 Emacs作为神的编辑器，不用介绍了吧，说点感受。 用了一段时间了，总体感觉其实Emacs是很简单的，甚至比vim还简单，因为在X环境下，打开后可以就像记事本一样使用。但是，使用Emacs的人一般都是程序员，而Emacs要用来编程，总没有那些IDE好用，还总想把它折腾成好用的IDE，但又苦于没 阅读全文
posted @ 2018-01-04 16:38 windtail 阅读(324) 评论(0) 推荐(0)
luacom cygwin
摘要：前一段时间想用luacom来操作word文档，最终发现总有那么点问题。这两天用cygwin写bash脚本来完成一些Word文档操作，不得已总要调用cscript，通过javascript来访问wordr com对象，而这样调用cscript有两个问题让我很不爽：cscript又只接受Windows格式的路径，每次都要用 $(cygpath -w xxx) 来转换路径cscript输出或错误都是gb2312的，每次都要转换成utf-8：cscipt //nologo xxxxx.js 2>&1 | piconv -f gb2312 -t utf-8Cygwin如何直接访问com对象 阅读全文
posted @ 2012-07-01 17:51 windtail 阅读(1630) 评论(0) 推荐(0)
Word 模板 - 新建向导
摘要：向导Word 2010 Bible 上说有的模板，在基于它新建文件时，可以弹出一个新建向导。然后，我就特别地想实现这个功能，比如新建若干个节，新建目录等。跑到 http://word.mvps.org 上搜索了下，果然有方法，简单的说就是 在模板工程的ThisDocument中，新建一个Document_New()过程，并实现之。复杂地说就是：双击 ThisDocument 在右边打开的编辑区上方有两个组合框，选择左边那个框中的 Document，你会发现Word自动新建一个Document_New过程添加自定义Form，做成向导即可页面设置向导做完以后，一般来说需要进行页面设置。我看了半天帮 阅读全文
posted @ 2011-11-14 23:35 windtail 阅读(698) 评论(0) 推荐(0)
Word 输入可见空格 “␣”
摘要：写编程语言的格式说明时，为了强调空格的作用，需要可见空格，LaTeX中有对应的命令，参见ctex-faq，但是Word里怎么整呢？强大的Word有一个这样的功能，输入字符的16进制编号，然后立即按下Alt+X，可以转换为对应的字符。可能很少人关注，插入符号的对话框下面写的，“快捷键：xxxx, Alt+X”吧，就是这个功能！所有的符号都可以这么插入！到英文Wiki上搜索”space code“，可以插到各种space编码，2423即是我想要的，输入 ”2423”，然后按下Alt+X，成功插入“␣”！ 阅读全文
posted @ 2011-10-23 23:44 windtail 阅读(785) 评论(0) 推荐(0)
Word 其实可以很强大！
摘要：刚用上Word 2010，目前看来除了多人协作、主控文档让我失望以外，2010基本上还是令我满意的。最近给公司写说明书，总结了许多写Word的经验，本来想拿来写写，不过，前天看了本书，Microsoft Office Word 2010 Bible发现上面都已经写得很好了，佩服外国人写书的认真，相比起来国内的一些写Word的书都很垃圾。当然，《Word排版艺术》一书写得还算可以，不过和这本Bible比起来，还差之甚远，这本书的作者把Word摸得太透彻了，真不知道花了多少时间！注：Bible这本书在CSDN上有电子版下载，卓越上也有卖，不过要200多~~ 阅读全文
posted @ 2011-10-23 23:33 windtail 阅读(251) 评论(0) 推荐(0)
LaTeX 排版C语言代码
摘要：转载自http://blog.sina.com.cn/s/blog_51e68f8d0100avil.html转载自http://blog.linuxgem.org/lyanry/show/319.htmllistings 是专用于代码排版的 LaTeX宏包，可对关键词、注释和字符串等使用不同的字体和颜色或颜色，也可以为代码添加边框、背景等风格。1 基本用法下面给出一份用于排版 C 语言 HelloWorld 程序代码的完整的 LaTeX 文档：\documentclass{article}\usepackage{listings}\begin{document}\begin{lstlisti 阅读全文
posted @ 2011-08-24 00:16 windtail 阅读(5065) 评论(0) 推荐(1)
Installing a package yourself
摘要：Installing a package yourselfThe following are the steps that you should follow to install a new LaTeX package into your own home directory.Download the package file(s) from wherever they are available. Most packages are available fromCTAN; enter appropriate keywords in the search fields to find the 阅读全文
posted @ 2011-08-01 22:18 windtail 阅读(223) 评论(0) 推荐(0)