TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Publishing / typesetting print documentation in HTML + CSS (+JS)
Subject:Publishing / typesetting print documentation in HTML + CSS (+JS) From:Jimmy Breck-McKye <jb527 -at- hotmail -dot- co -dot- uk> To:<techwr-l -at- lists -dot- techwr-l -dot- com> Date:Sun, 14 Aug 2011 12:05:11 +0000
Does anyone here have any experience publishing paper documentation using HTML and CSS?
Because my job involves testing and diagnosing problems in web applications, I've an awful lot of opportunities to learn about these technologies. It makes sense to learn one, versatile tool well rather than two poorly. It also makes sense to use technologies that are well-documented and easily understood by my peers. CSS helps me tick all these boxes.Practically speaking, I'm told that print CSS handling is quite mature on certain browsers, and from what I've seen, it looks as though CSS can do an awful lot. It also looks pretty straightforward to implement an XML - XSLT - HTML + CSS toolchain (as much as XSLT's syntax irritates me). Working in plain XML would free me to implement parts of my toolchain in other technologies, too (I've had especially good experiences transforming XML with Python scripts).But that's just the theory. Does anyone have any practical experience on this point? Any advice or common pitfalls?Thanks in advance,Jimmy/p>(Also, apologies if the carriage returns are broken. The Techwr-l mail handler seems to have a particular issue with my emails)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days. http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
