Posts Tagged documentation

Word 2007 Blank Pages Between Chapters

Word 2007 Blank Pages Between Chapters

While working on a documentation project for a client we ran into a unique problem.  According to good technical writing practices, you always want chapters to start on an odd page.  This puts new chapters on the right-hand page of a bound book.  You also want to ensure that any preceding blank page is not 100% blank, most standards dictate at least a footer with a page number and possibly a header with the title of the prior chapter (old school methods were to put a "This page intentionally left blank." message on the preceding blank page, which is one of my favorite all time ironies).  After digging around for hours (OK, maybe 10 minutes) I found the solution to this blank page problem. It turns out that when you are forcing pages to start on an odd page # for things ...

0 Comment   |   Posted in Desktop Apps,Word,blog June 22, 2010

Easy Documentation for Git, MySQL, PHP, et cetera

This is what I do on my box to quickly find documentation, which you guys may find helpful.  Especially those of you on Linux---although you could do this on Windows too. Most package managers make available '-doc' packages, like php-doc, mysql-doc, and so on.  Install these for all the major software you use. Next, install 'screen'. Now put this is your Bash config: # Displays various types of documentation. function doc() {     case "$1" in     'llvm')         screen -t 'LLVM Documentation' w3m /usr/share/doc/llvm-doc/html/index.html ;;     'erlang')         screen -t 'Erlang Documentation' firefox /usr/share/doc/erlang-doc-html/html/doc/index.html ;;     'python')         screen -t 'Python Documentation' w3m /usr/share/doc/python3-doc/html/index.html ;;     'php')         screen -t 'PHP Documentation' w3m /usr/share/doc/php-doc/html/index.html ;;     'ghc')         firefox /usr/share/doc/ghc6-doc/index.html & ;;     'postgresql')         screen -t 'PostgreSQL Documentation' w3m /usr/share/doc/postgresql-doc-8.4/html/index.html ;;     'mysql')         screen -t 'MySQL Documentation' w3m /usr/share/doc/mysql-doc-5.0/refman-5.0-en.html-chapter/index.html ;;     'apache')         screen -t 'Apache Documentation' w3m /usr/share/doc/apache2-doc/manual/index.html ;;     'j')         screen -t 'J Documentation' w3m ~/Software/j602/help/index.htm ;;     'lua')         screen -t 'Lua Documentation' w3m /usr/share/doc/lua5.1-doc/doc/index.html ;;     'git')         ...

0 Comment   |   Posted in Tips & Tricks,blog January 22, 2010