(Sorry - couldn't find a generic DocBook NG - I hope this is close
enough.)
I'm considering moving my documentation and translation business -
which is currently done in proprietary formats such as FrameMaker,
Word and XPress - to a system centered around DocBook. I'm currently
reading "DocBook - The Definitive Guide", but I'll need a few answers
ASAP ... So maybe a kind soul could give me at least a few hints.
1) Storing documents in databases
Instead of working with large, "monolithic " files, I'd like to store
technical documents as collections of re-usable segments in a
database. So the document should only be some kind of "outline", while
the actual content of sections/paragraphs is written to/pulled from a
database on a local or remote server; sort of like includes.
Is this feasible for someone without an enterprise IT budget (i.e., a
freelance author/translator team), and what tools are involved? I
suppose you need an SQL DB, some kind of middleware and an XML editor.
Does anyone here have experience with working/reliable/affordable
setups?
2) DocBook to PDF
a) I understand that conversion to PDF is possible using FOP. The
question is: Is it also practical/realistical to use this in a
production environment? I.e., will it work reliably?
b) Can I expect features such as multi-column layouts, headers and
footers, multiple templates for cover, body, index pages, inclusion of
images etc.?
c) How does the Renderer/Objects Processor map internal
cross-references to pages? Is it possible to do cross-references such
as "see Section X on page y?"
3) Conditional text
Is it possible to specify formats to exclude sections of a document,
based on content, language or output format? I.e., I'd like to specify
attributes such as "Print Version only", "Digest/Full Version". Can
this be done?
4) "Locking" tags
If all this is possible, I'll use this setup with other
authors/translators. In this case, I'd like to keep them from
accidentally deleting markup. E.g., I'd like to duplicate an existing
German document and allow the English translator to modify/translate
text, but not delete or re-arrange headers and sections.
Are there editors that allow this kind of "granular" locking?
I know these are big issues, and I'll have to do a lot of Googling and
reading from here, anyway. But if someone could at least point me in
the right direction, I'd be grateful.
TIA. 1 2677
David Winter wrote: (Sorry - couldn't find a generic DocBook NG - I hope this is close enough.)
there is one at http://www.oasis-open.org/docbook/mailinglist/
you probably are looking for the docbook-apps list.
many of your non xml-authoring questions are nicely answered here: http://www.sagehill.net/docbookxsl/index.html I'm considering moving my documentation and translation business - which is currently done in proprietary formats such as FrameMaker, Word and XPress - to a system centered around DocBook. I'm currently reading "DocBook - The Definitive Guide", but I'll need a few answers ASAP ... So maybe a kind soul could give me at least a few hints.
1) Storing documents in databases
Instead of working with large, "monolithic " files, I'd like to store technical documents as collections of re-usable segments in a database. So the document should only be some kind of "outline", while the actual content of sections/paragraphs is written to/pulled from a database on a local or remote server; sort of like includes.
Is this feasible for someone without an enterprise IT budget (i.e., a freelance author/translator team), and what tools are involved? I suppose you need an SQL DB, some kind of middleware and an XML editor. Does anyone here have experience with working/reliable/affordable setups?
you can modularize your documents via XInclude.
a minimalistic approach could store everything in a CVS repository.
2) DocBook to PDF
a) I understand that conversion to PDF is possible using FOP. The question is: Is it also practical/realistical to use this in a production environment? I.e., will it work reliably?
there are both open source (FOP) and commercial pdf-renderers (e.g. from
RenderX). in my experience FOP works reliable, but still has quite some
limitations.
b) Can I expect features such as multi-column layouts, headers and footers, multiple templates for cover, body, index pages, inclusion of images etc.?
sure, but you need the corresponding stylesheets
c) How does the Renderer/Objects Processor map internal cross-references to pages? Is it possible to do cross-references such as "see Section X on page y?"
see sagehill
3) Conditional text
Is it possible to specify formats to exclude sections of a document, based on content, language or output format? I.e., I'd like to specify attributes such as "Print Version only", "Digest/Full Version". Can this be done?
the docbook stylesheets support profiling 4) "Locking" tags
....
hth,
m. This thread has been closed and replies have been disabled. Please start a new discussion. Similar topics |
by: Markus Hoenicka |
last post by:
Hi all,
I'm trying to transform a simple test document to PDF using
Passivetex. I'm not sure where to look for the error, but something in
the toolchain doesn't cooperate, resulting in the following TeX error
message:
! Missing number, treated as zero.
<to be read again>
p
|
by: ZJT |
last post by:
What are the ways and corresponding tools to transform a docbook
document to a pdf document? Thanks a lot!
|
by: David Montgomery |
last post by:
Hi,
Our company provides ASP services to multiple government agencies. These
agencies in turn provide our ASP services to the general public through
their web portals. As part of our service we need to provide end-user
documentation for the general public to use our ASP tools, providing
really simple to understand step-by-step instruction with lots and lots
of picture examples.
As part of my project to create this documentation, I...
|
by: Daniel Meilleur |
last post by:
Hi,
I try to use a customization stylesheet following example given by
B.Stayton
(http://www.sagehill.net/docbookxsl/CustomGentext.html#CustomGenText)
i.e.:
<?xml version='1.0'?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
version="1.0">
|
by: Yarco |
last post by:
I'm learning for docbook under win32.
I download:
openjade-1_3_1-2-bin
docbook-xml-4.4
docbook-dsssl-1.79
ldp.dsl
And then copy all openjade bin\ to win32 system\, and then create a
directory share\ under my workhome.
Copy openjade-dsssl, docbook-xml-4.4, docbook-dsssl-1.79 to share\.
ldp.dsl into docbook-dsssl-1.79\html\.
| |
by: mike p. |
last post by:
I have a docbook xml file, and am using standard docbook 1.61.3 xsl
stylesheets to do xhtml transform. Transform works fine when using
MSXML.
When I try to do the following using asp.net 1.1:
private void Page_Load(object sender, System.EventArgs e) {
// load content
XslTransform trans = new XslTransform();
|
by: Otmar Ganahl |
last post by:
Hi!
In my application I transform a docbook file to a html
view using the webcontrol "Xml" (with a xsl).It works
fine, except the using of the tag "fileref" in the
docbook-file will cause an exception:
_ctl1_DesktopThreePanes1_ThreePanes__ctl3_xml1: Failed!
Object reference not set to an instance of an object.
(The IE6.0 xml-parser transform the docbook file
|
by: Jim Anderson |
last post by:
This is my first attempt at XML documentation.
I'm trying to get started with docbook so I can put a set
of documentation into docbook tags. I'm using 'XML In A
Nutshell" and "DocBook The Definitive Guide", both of which
are a bit outdated already.
I have a simple file that parses, but when I read it into
Netscape or Konqueror, I do not get the results that I would
hope for.
|
by: tthunder |
last post by:
Hi @all,
I have a very simple use case here, but I cannot get any answer.
I want to publish/provide a customized XSL Stylesheet for DocBook
Users. The stylesheet defines variables for the DocBook Stylesheets,
e.g.
<xsl:variable name="html.stylesheet.type">text/css</xsl:variable>
<xsl:variable name="html.stylesheet" select="mystyle.css'"></
|
by: marktang |
last post by:
ONU (Optical Network Unit) is one of the key components for providing high-speed Internet services. Its primary function is to act as an endpoint device located at the user's premises. However, people are often confused as to whether an ONU can Work As a Router. In this blog post, we’ll explore What is ONU, What Is Router, ONU & Router’s main usage, and What is the difference between ONU and Router. Let’s take a closer look !
Part I. Meaning of...
|
by: tracyyun |
last post by:
Dear forum friends,
With the development of smart home technology, a variety of wireless communication protocols have appeared on the market, such as Zigbee, Z-Wave, Wi-Fi, Bluetooth, etc. Each protocol has its own unique characteristics and advantages, but as a user who is planning to build a smart home system, I am a bit confused by the choice of these technologies. I'm particularly interested in Zigbee because I've heard it does some...
| |
by: agi2029 |
last post by:
Let's talk about the concept of autonomous AI software engineers and no-code agents. These AIs are designed to manage the entire lifecycle of a software development project—planning, coding, testing, and deployment—without human intervention. Imagine an AI that can take a project description, break it down, write the code, debug it, and then launch it, all on its own....
Now, this would greatly impact the work of software developers. The idea...
|
by: isladogs |
last post by:
The next Access Europe User Group meeting will be on Wednesday 1 May 2024 starting at 18:00 UK time (6PM UTC+1) and finishing by 19:30 (7.30PM).
In this session, we are pleased to welcome a new presenter, Adolph Dupré who will be discussing some powerful techniques for using class modules.
He will explain when you may want to use classes instead of User Defined Types (UDT). For example, to manage the data in unbound forms.
Adolph will...
|
by: conductexam |
last post by:
I have .net C# application in which I am extracting data from word file and save it in database particularly. To store word all data as it is I am converting the whole word file firstly in HTML and then checking html paragraph one by one.
At the time of converting from word file to html my equations which are in the word document file was convert into image.
Globals.ThisAddIn.Application.ActiveDocument.Select();...
|
by: adsilva |
last post by:
A Windows Forms form does not have the event Unload, like VB6. What one acts like?
|
by: 6302768590 |
last post by:
Hai team
i want code for transfer the data from one system to another through IP address by using C# our system has to for every 5mins then we have to update the data what the data is updated we have to send another system
|
by: muto222 |
last post by:
How can i add a mobile payment intergratation into php mysql website.
| |
by: bsmnconsultancy |
last post by:
In today's digital era, a well-designed website is crucial for businesses looking to succeed. Whether you're a small business owner or a large corporation in Toronto, having a strong online presence can significantly impact your brand's success. BSMN Consultancy, a leader in Website Development in Toronto offers valuable insights into creating effective websites that not only look great but also perform exceptionally well. In this comprehensive...
| | |