轻松(如所见即所得)自定义文档输出
我过去使用过 DocBook,并且喜欢将内容与演示分离背后的想法。我很乐意直接编辑 XML。在我广泛搜索以找到最适合我的需求的文档解决方案时,我总是回到这个解决方案:
DocBook ->构建系统(ant、make等)->输出
我已经看到很多关于用于编写 DocBook 的最佳 WYSIWYG、XML、文本编辑器的信息,包括替代标记语言(如 asciidoc)。所有这些解决方案都集中在 DocBook 的创建或 DocBook 工具链的噩梦上。没有人会在输出方面说“只需使用 XSL”或“自定义脚本”。
当我被要求制作文档或手册时,我不想担心花费无数时间尝试重新编程、自定义和修改 XSL 、CSS 和 shell 脚本(即 O'Riely 书籍)。这是一项非常艰巨的任务。
我的疑问:有没有一种工具可以使定制变得更容易?有没有什么东西可以类似于 Pages 或 Word,用户创建模板,工具链完成其余的工作?在文本编辑器中尝试执行诸如漂亮徽标之类的视觉任务并修复默认 XSL 带来的所有损坏的布局(分页一团糟)是非常困难的。内容很简单。当我过去编辑 DocBook XSL 时,这确实是一场噩梦。我进行了搜索,找到了大量有关 XML 编辑器的信息,但没有找到有关 XSL 编辑器的信息。
或者我对这个过程缺乏关键的理解。谢谢。
I've used DocBook in the past and I love the idea behind the separation of content from presentation. I am very comfortable editing XML directly. In my extensive search to find the best documenting solution for my needs I am always coming back to this one solution:
DocBook -> Build system (ant, make, etc.) -> Output
I have seen lots of information concerning the best WYSIWYG, XML, Text editors for writing DocBook including alternative markup languages like asciidoc. All these solutions focus on the creation of DocBook or the nightmare of the DocBook tool chain. No one ever addresses the Output side other then to say "Just use XSL" or "Custom scripts"
When tasked to make a document or manual I don't want to worry about spending countless hours attempting to reprogram, customize, and modify the XSL, CSS, and shell scripts (i.e. O'Riely books). That is a very arduous task.
My query: is there a tool that makes the customizing easier? And is there anything that could be similar to say Pages or Word in that the user creates a template and the tool chain does the rest? Attempting to do a visual task like pretty logos and fixing all the broken layouts that the default XSL comes up with (pagination is a mess) is very difficult from a text editor. Content is easy. Editing DocBook XSL was truly a nightmare when I did it in the past. I've searched and I find lots of info on XML editors but nothing on XSL editors.
Or am I lacking a key understanding of the process. Thanks.
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论
评论(2)
我认为这不是您所要求的,但我一直在使用两个 CLI 实用程序来简化我的文档工具链:xmlto 和 publican。
Publican 对我来说看起来很优雅,但足够适合 Fedora 和 Fedora 了。 Redhat发布需要。
I think this is not what you are asking for but I've been using two CLI utils for simplifying my docbook toolchain: xmlto and publican.
Publican looks elegant to me but enough fitted for the Fedora & Redhat publication needs.
使用样式表。 CSS 比你想象的更简单,只要你远离愚蠢的废话,比如圆角、渐变背景和其他你不需要的无关内容。下面是经过跨浏览器美化和测试的 XML 文档示例:
http://mailmarkup。 org/hcl/hcl1_0-documentation.xsd
Use a stylesheet. CSS is more simple than you think so long as you stay from stupid crap like rounded corners, gradient backgrounds, and other irrelevance that you don't need. Here is an example of an XML document that is beautified and tested cross browser:
http://mailmarkup.org/hcl/hcl1_0-documentation.xsd