Re: [docbook] Modeling social media conversations?

2012-01-24 Thread Lech Rzedzicki
On Tue, Jan 24, 2012 at 2:54 PM, Norman Walsh n...@nwalsh.com wrote:
 Hello world, anyone done any work modeling social media conversations?

I'd say it needs to modeled as a simplified form of Semantic Web,
following RESTful approach.

You identify the resources here, which end up having URIs, that is:
posting (tweet, G+ post, FB status update etc)
user (typically I would not repeat all the user info every time if I
have the URI to identify, but that could be my relational d b
thinking)

Then using those URIs you can say additional things about these
resources - i.e. if the post has been retweeted from elsewhere, you'd
probably ref the URI of that post, if you want to mention a person or
an account you ref the URI of that user.

I wouldn't go too far in defining specific actions for a specific
service - some people insist on using instagram or flickr when sharing
photos, even when the actual sharing happens on facebook, is that a
facebook or flickr interaction, does it matter?
Instead I'd focus on modelling the interactions - the fact that the
post is retweeted means it's gaining popularity and could possibly be
hijacked for marketing purposes, for example.
Currently I don't see you gathering bits like how many times has this
been shares or a number of +1, arguably this is more important than
who as was the case with hundreds retweeting iBook author EULA...

One final bit I'd take into consideration is:
a) the technology that's been used to create those social interactions
b) the way you might want to consume and process what you've just captured.

ad a) Both twitter and facebook have initially built their sites with
relational db's on the backend (Ror / php) so in some ways,
interactions with those sites is still limited somewhat and while
improvements have already been announced, the only verb you can use on
facebook posts is still like, even if it's a post on genocide. I'm
sure that somewhere behind layers of memcached there's still the posts
table and the users table and mirroring that in XML is trivial.
Ad b) I obviously understand the reasons to model this in XML, but it
is very likely that this sort of data will want to be consumed in JSON
or more generally in key/value pairs, so model it so that the XML can
split and rebuilt from those pairs trivially.

Finally how's that related to docbook? ;)


Lech

-
To unsubscribe, e-mail: docbook-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-h...@lists.oasis-open.org



[docbook] Re: Modeling social media conversations?

2012-01-24 Thread Norman Walsh
Lech Rzedzicki l...@kode1100.com writes:
 On Tue, Jan 24, 2012 at 2:54 PM, Norman Walsh n...@nwalsh.com wrote:
 Hello world, anyone done any work modeling social media conversations?

 I'd say it needs to modeled as a simplified form of Semantic Web,
 following RESTful approach.
[...]
 Finally how's that related to docbook? ;)

It's related because I want to incorporate the postings into a DocBook
document. I'm not trying to model the entire service, just collections
of postings. Granted, it's a stretch...

But something like this:

http://norman.walsh.name/2012/01/22/shortform-t.xml

and this:

http://norman.walsh.name/2012/01/22/shortform.xml

Be seeing you,
  norm

-- 
Norman Walsh n...@nwalsh.com  | Any sufficiently advanced
http://www.oasis-open.org/docbook/ | technology is indistinguishable
Chair, DocBook Technical Committee | from a rigged demo.


pgp8EGXywedOB.pgp
Description: PGP signature


[docbook] how to include title and caption

2012-01-24 Thread Paul Tremblay
The docbook standard allows you to use either a caption or a title. I would
like to use both.

There is this option:

doc:table class=long-metrics title=Carousel Picking 2010-2011
tabstyle=long
doc:caption
   Data for Carousel picking, 2010-2011. The
rate did not change for Carousel picking. Carousel picking handles a small
amount of volume, but at a faster rate.
  /doc:caption

However, the standard XSL stylesheets will not format both.

I know how to customize the stylesheets, but I am wondering why it is
difficult to format both. Is it not usual to have both a title and caption?


Re: [docbook] how to include title and caption

2012-01-24 Thread Bob Stayton
Hi Paul,
This combination appears to have been missed by the FO stylesheet.  But some 
clarification is in order.

DocBook 5 supports two table models: CALS-markup and HTML-markup tables. When 
you use the HTML-markup model, its caption element replaces the title element, 
based on how W3C HTML tables are modeled.  So you cannot use both title and 
caption with an HTML-markup table.  That version of the caption element has a 
content model like title, allowing only text and inlines.

If you use CALS-markup, you can put a title at the beginning and a caption at 
the end. That version of the caption element can contain para and other block 
elements.  Currently the FO stylesheet does not format the caption at the end, 
which I believe is an oversight.  The HTML stylesheet does.  

Thanks for the bug report.  I just checked in an update for the FO stylesheet 
to process caption in a CALS-markup table. That fix will  appear in the next 
release.

If you want to add the fix to your customization layer, you would need to copy 
the template named calsTable from fo/table.xsl to your customization layer 
and add this line at the end of the template:

xsl:apply-templates select=d:caption/


Bob Stayton
Sagehill Enterprises
b...@sagehill.net


  - Original Message - 
  From: Paul Tremblay 
  To: docbook@lists.oasis-open.org 
  Sent: Tuesday, January 24, 2012 12:47 PM
  Subject: [docbook] how to include title and caption


  The docbook standard allows you to use either a caption or a title. I would 
like to use both. 

  There is this option:

  doc:table class=long-metrics title=Carousel Picking 2010-2011 
tabstyle=long
  doc:caption
 Data for Carousel picking, 2010-2011. The
  rate did not change for Carousel picking. Carousel picking handles a small
  amount of volume, but at a faster rate.
/doc:caption

  However, the standard XSL stylesheets will not format both. 

  I know how to customize the stylesheets, but I am wondering why it is 
difficult to format both. Is it not usual to have both a title and caption?


Re: [docbook-apps] 'hyphenate.verbatim' parameter and FOP

2012-01-24 Thread Radu Coravu

Hi,

Just updating this thread with the answer you received on the Oxygen 
Users List:



http://www.oxygenxml.com/pipermail/oxygen-user/2012-January/003976.html


Regards,
Radu

Radu Coravu
oXygen/  XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com

On 1/23/2012 11:07 AM, Tony Graham wrote:

Using oXygen 13.2's DocBook FO stylesheets and FOP and the
programlisting  in the document below (hopefully the longer lines weren't
wrapped by my mailer), when the 'hyphenate.verbatim' parameter is set to
'1', the transformation fails with the following message:


System ID: Untitled1.xml
Scenario: Docbook PDF duplicate
XML file: Untitled1.xml
XSL file: C:\Program Files\Oxygen XML Editor
13\frameworks\docbook\xsl\fo\docbook_custom.xsl
Engine name: Apache FOP
Severity: error
Description: The process 'Apache FOP' ended with code: 1.
The error was:
ERROR - Exception
java.lang.IllegalArgumentException: factor  0; was: -1
at org.apache.fop.cli.InputHandlerFOP.transformTo(Unknown Source)
at org.apache.fop.cli.InputHandlerFOP.renderTo(Unknown Source)
at org.apache.fop.cli.Main.startFOP(Main.java:174)
at org.apache.fop.cli.Main.main(Main.java:205)
Caused by: java.lang.IllegalArgumentException: factor  0; was: -1
at org.apache.fop.traits.MinOptMax.mult(MinOptMax.java:251)
at
org.apache.fop.layoutmgr.inline.TextLayoutManager.processWord(TextLayoutManager.java:825)


This appears to be fixed in FOP post-1.0:

https://issues.apache.org/bugzilla/show_bug.cgi?id=49837

but installing a development version of FOP isn't really an option.

Has anyone else seen this?  Seen this and found a solution?

Regards,


Tony Graham   tgra...@mentea.net
Consultant http://www.mentea.net
Mentea   13 Kelly's Bay Beach, Skerries, Co. Dublin, Ireland
  --  --  --  --  --  --  --  --  --  --  --  --  --  --  --  --
 XML, XSL-FO and XSLT consulting, training and programming


article xmlns=http://docbook.org/ns/docbook;
 xmlns:xlink=http://www.w3.org/1999/xlink; version=5.0
 titletagcode/tag  Breaking/title
 programlisting  There was movement at the station, for the word
had passed around
  That the colt from old Regret had got away,
  And had joined the wild bush horses -- he was worth a thousand pound,
  So all the cracks had gathered to the fray.
  All the tried and noted riders from the stations near and far
  Had mustered at the homestead overnight,
  For the bushmen love hard riding where the wild bush horses are,
  And the stock-horse snuffs the battle with delight.
/programlisting
/article


-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



Re: [docbook-apps] Customizing and creating a stylesheet for docbook using the XML Mind or Oxygen XML Editor

2012-01-24 Thread Radu Coravu

Hi Daniel,

Oxygen (and most probably also XML Mind) uses CSS stylesheets in order 
to display the XML in the Author editing mode in a visual pleasing manner.
Those CSS styles which you use for visual editing do not influence the 
publishing in any way.
Output for PDF (and for XHTML, etc) can indeed be customized by setting 
XSLT parameters to the publishing transformation scenario.


Regards,
Radu

Radu Coravu
oXygen/  XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com


On 1/23/2012 2:38 PM, daniel.ke...@finaris.de wrote:

Hello,

sorry that it took so long, but I was quite busy.
Thanks for all the response - it made things easier for us.

The customization process is getting along pretty well, but we still
have some questions regarding the PDF Output:

As said before, we customized Docbook to match our requirements. We
basically added a few elements to the schema and blocked those we didn’t
want. The font size etc. is determined by an css style sheet.

One problem is, that most of our new styles are not recognized if we
output a document as a PDF. We already found the param.xml and
pagesetup.xsl file, but were not sure if it is necessary to customize
them as well. Did we go wrong using css instead of xsl as a stylesheet?
Oxygen handles both, but it seems like only xls is supported for
creating a PDF.

Another problem that we have is, that we can´t really figure out how to
influence the general page layout (header, footer, graphic on the front
page etc.). Is there any tutorial or something?

Finally, at least for now, we are wondering how to insert text boxes in
line with the text, since in our current configuration text boxes are
always inserted below the paragraph.



Thanks for the help and sorry if some questions might seem unnecessary.
I´m not one of the XML guys in the company, but rather one of those who
write and translate.

Greetings,

Daniel

From:   daniel.ke...@finaris.de
To: docbook-apps@lists.oasis-open.org
Date:   17.01.2012 09:44
Subject:[docbook-apps] Customizing and creating a stylesheet for
docbook using the XML Mind or Oxygen XML Editor






Hello,

currently my company is thinking about transferring its user
documentation into XML and docbook.
Since we are an IT company, XML and programming in general is not a
problem. But: We cannot find and adjust the stylesheet needed to create
our custom documentation.
We are currently setting up a prototype for our documentation, following
the instructions from Walsh´s DocBook 5: The definitive Guide and
working with the XML Mind Editor and a trial version of OXYGEN Editor.

Basically, we are satisfied with the results and trust in docbooks
function (since having lots of trouble with Word), but the lacking
transparency
http://shop.oreilly.com/product/9780596805012.do?sortby=publicationDatemakes
it really hard to come up with a sample documentation/ prototype .Each
file we open has at least one reference to a website we cannot open and
dozens of files that don´t exist or are really hard to find. We checked
the regular docbook.zip from the docbook homepage, but also all files of
the respective editors. (Is there something as a default Docbook
editor that you would propose?)

Can anyone give me some advice, a link or even a how-to for adjusting
the docbook stylesheet? Personally, I would love to use docbook for our
user documentation, simply for the additional features it has compared
to other text processing program, but only if I can adjust the
appearance. Especially regarding corporate identity this is absolutely
necessary.

Thanks and with best regards,


D. Keyes




===
Disclaimer
The information contained in this e - mail and any attachments
( together the message) is intended for the addressee only and may
contain confidential and/or privileged information. If you have received
the message by mistake please delete it and notify the sender and do
not copy or distribute it or disclose its contents to anyone.

FINARIS Financial Software Partner GmbH
Sömmerringstr. 23, 60322 Frankfurt/Main, Germany
Registered at Frankfurt/Main, HRB 52873

Managing Directors:
Dipl. Inf. Hermann Friebel, Dipl. Ing. Kai Bächle, Dipl. Inf. Werner Märkl
===




-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



Re: [docbook-apps] Tripane output

2012-01-24 Thread Jirka Kosek
On 24.1.2012 15:23, Stefan Hinz wrote:
 Has anyone on this list created a tripane (X)HTML output from DocBook XML? 
 Something like this (the live version is here 
 http://docs.oracle.com/cd/E19351-01/821-1927/z40008479112.html):

Try WebHelp output:

http://docbook.sourceforge.net/release/xsl/current/webhelp/docs/content/ch01.html

-- 
--
  Jirka Kosek  e-mail: ji...@kosek.cz  http://xmlguru.cz
--
   Professional XML consulting and training services
  DocBook customization, custom XSLT/XSL-FO document processing
--
 OASIS DocBook TC member, W3C Invited Expert, ISO JTC1/SC34 member
--



signature.asc
Description: OpenPGP digital signature


Re: [docbook-apps] Tripane output

2012-01-24 Thread David Cramer
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

On 01/24/2012 09:15 AM, Jirka Kosek wrote:
 On 24.1.2012 15:23, Stefan Hinz wrote:
 Has anyone on this list created a tripane (X)HTML output from
 DocBook XML? Something like this (the live version is here 
 http://docs.oracle.com/cd/E19351-01/821-1927/z40008479112.html):

 
 Try WebHelp output:
 
 http://docbook.sourceforge.net/release/xsl/current/webhelp/docs/content/ch01.html

 
Btw., the version in svn has many improvements:

http://snapshots.thingbag.net/xsl/webhelp/docs/content/index.html

David
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEcBAEBAgAGBQJPHtKXAAoJEMHeSXG7afUhYOEH/2S28anDOFJ35DrUsrrhNYjJ
A2bmxF4qQM6zzj93m7ddsbHGIxkkoW7kM/v04v+B3URCobidpgVt1yUY/bd1XrYh
DQ/wEWYLin950HMPbGaBTryTf6hB3UgwPsDdYVo+idngLLVp+yaQQsGw0oUJUXUz
dm5Kd9Yb84mLj9QJxsxgK3tsPUCrj1HU7YPaDuWcHASnrkJ5LB+HzyLLvr242U5N
IdgA+xUa7o3DHI/g15J71rdLEjRgnY8CqjNPHTx26qwUVULsAr6a9uiXTybVqK85
iR+Q7vdP2t+Zp7eVE73pUT6vFwwr5y2jRx/3MIKeKeJI4+hJj3JHIhYVzpiJYrE=
=+HHA
-END PGP SIGNATURE-

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



Re: [docbook-apps] Tripane output

2012-01-24 Thread Stefan Hinz

David, Jirka, Peter,

You guys rock! :-) Thank you so much for your pointers!

So it turns out that a task I had considered mission impossible this 
morning is little more than a standard thing.


I'll talk to Peter to see if I can borrow his adaptation of WebHelp for 
OTN (Oracle Technology Network).


Again, thanks much. You guys have saved my day!

Cheers,

Stefan

On 24.01.2012 16:47, David Cramer wrote:

-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

On 01/24/2012 09:15 AM, Jirka Kosek wrote:

On 24.1.2012 15:23, Stefan Hinz wrote:

Has anyone on this list created a tripane (X)HTML output from
DocBook XML? Something like this (the live version is here
http://docs.oracle.com/cd/E19351-01/821-1927/z40008479112.html):





Try WebHelp output:

http://docbook.sourceforge.net/release/xsl/current/webhelp/docs/content/ch01.html



Btw., the version in svn has many improvements:

http://snapshots.thingbag.net/xsl/webhelp/docs/content/index.html

David
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEcBAEBAgAGBQJPHtKXAAoJEMHeSXG7afUhYOEH/2S28anDOFJ35DrUsrrhNYjJ
A2bmxF4qQM6zzj93m7ddsbHGIxkkoW7kM/v04v+B3URCobidpgVt1yUY/bd1XrYh
DQ/wEWYLin950HMPbGaBTryTf6hB3UgwPsDdYVo+idngLLVp+yaQQsGw0oUJUXUz
dm5Kd9Yb84mLj9QJxsxgK3tsPUCrj1HU7YPaDuWcHASnrkJ5LB+HzyLLvr242U5N
IdgA+xUa7o3DHI/g15J71rdLEjRgnY8CqjNPHTx26qwUVULsAr6a9uiXTybVqK85
iR+Q7vdP2t+Zp7eVE73pUT6vFwwr5y2jRx/3MIKeKeJI4+hJj3JHIhYVzpiJYrE=
=+HHA
-END PGP SIGNATURE-



--
Cheers,

Stefan Hinz stefan.h...@oracle.com, MySQL Documentation Manager

Phone: +49-30-82702940, Fax: +49-30-82702941, http://dev.mysql.com/doc

ORACLE Deutschland B.V.  Co. KG
Registered Office: Riesstr. 25, 80992 Muenchen, Germany
Commercial Register: Local Court Of Munich, HRA 95603
Managing Director: Jürgen Kunz

General Partner: ORACLE Deutschland Verwaltung B.V.
Hertogswetering 163/167, 3543 AS Utrecht, Niederlande
Register Of Chamber Of Commerce: Midden-Niederlande, No. 30143697
Managing Directors: Alexander van der Ven, Astrid Kepper, Val Maher

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org



Re: [docbook-apps] Customizing and creating a stylesheet for docbook using the XML Mind or Oxygen XML Editor

2012-01-24 Thread Bob Stayton
Hi Daniel,
CSS has progressed to the point where it can format printed output, and I know 
of at least one product that can use CSS to generate PDF output (Antenna House 
XSL Formatter http://www.antennahouse.com/product.htm).  But most people use 
DocBook's XSL-FO output (fo/docbook.xsl) and an XSL-FO processor such as FOP to 
generate PDFs from DocBook content.

I believe someone pointed you to my online book DocBook XSL: The Complete Guide 
at http://www.sagehill.net/docbookxsl/index.html.  I believe it has the 
information you need to customize your PDF output.  This link will get you 
started with parameter setting:

http://www.sagehill.net/docbookxsl/PrintOutput.html

and this one with titlepage customization:

http://www.sagehill.net/docbookxsl/HTMLTitlePage.html

and this one will help with further customizations:

http://www.sagehill.net/docbookxsl/PrintCustomEx.html

Bob Stayton
Sagehill Enterprises
b...@sagehill.net


  - Original Message - 
  From: daniel.ke...@finaris.de 
  To: docbook-apps@lists.oasis-open.org 
  Sent: Monday, January 23, 2012 4:38 AM
  Subject: Re: [docbook-apps] Customizing and creating a stylesheet for docbook 
using the XML Mind or Oxygen XML Editor


  Hello, 

  sorry that it took so long, but I was quite busy. 
  Thanks for all the response - it made things easier for us. 

  The customization process is getting along pretty well, but we still have 
some questions regarding the PDF Output: 

  As said before, we customized Docbook to match our requirements. We basically 
added a few elements to the schema and blocked those we didn’t want. The font 
size etc. is determined by an css style sheet. 

  One problem is, that most of our new styles are not recognized if we output a 
document as a PDF. We already found the param.xml and pagesetup.xsl file, but 
were not sure if it is necessary to customize them as well. Did we go wrong 
using css instead of xsl as a stylesheet? Oxygen handles both, but it seems 
like only xls is supported for creating a PDF. 

  Another problem that we have is, that we can´t really figure out how to 
influence the general page layout (header, footer, graphic on the front page 
etc.). Is there any tutorial or something? 

  Finally, at least for now, we are wondering how to insert text boxes in line 
with the text, since in our current configuration text boxes are always 
inserted below the paragraph. 



  Thanks for the help and sorry if some questions might seem unnecessary. I´m 
not one of the XML guys in the company, but rather one of those who write and 
translate. 

  Greetings, 

  Daniel 

From:  daniel.ke...@finaris.de  
To:  docbook-apps@lists.oasis-open.org  
Date:  17.01.2012 09:44  
Subject:  [docbook-apps] Customizing and creating a stylesheet for 
docbook using the XML Mind or Oxygen XML Editor 


--



  Hello, 

  currently my company is thinking about transferring its user documentation 
into XML and docbook. 
  Since we are an IT company, XML and programming in general is not a problem. 
But: We cannot find and adjust the stylesheet needed to create our custom 
documentation. 
  We are currently setting up a prototype for our documentation, following the 
instructions from Walsh´s DocBook 5: The definitive Guide and working with 
the XML Mind Editor and a trial version of OXYGEN Editor. 

  Basically, we are satisfied with the results and trust in docbooks function 
(since having lots of trouble with Word), but the lacking transparency makes it 
really hard to come up with a sample documentation/ prototype .Each file we 
open has at least one reference to a website we cannot open and dozens of files 
that don´t exist or are really hard to find. We checked the regular docbook.zip 
from the docbook homepage, but also all  files of the respective editors. (Is 
there something as a default Docbook editor that you would propose?) 

  Can anyone give me some advice, a link or even a how-to for adjusting the 
docbook stylesheet? Personally, I would love to use docbook for our user 
documentation, simply for the additional features it has compared to other text 
processing program, but only if I can adjust the appearance. Especially 
regarding corporate identity this is absolutely necessary. 

  Thanks and with best regards, 


  D. Keyes 




  ===
  Disclaimer
  The information contained in this e - mail and any attachments
  ( together the message) is intended for the addressee only and may 
  contain confidential and/or privileged information. If you have received
  the message by mistake please delete it and notify the sender and do
  not copy or distribute it or disclose its contents to anyone.

  FINARIS Financial Software Partner GmbH
  Sömmerringstr. 23, 60322 Frankfurt/Main, Germany
  Registered at Frankfurt/Main, HRB 52873

  Managing Directors: 
  Dipl. 

RE: [docbook-apps] Customizing and creating a stylesheet for docbook using the XML Mind or Oxygen XML Editor

2012-01-24 Thread Jason Zech
I’m also a fan of PrinceXML, which generates PDF from any structured content 
using fairly robust CSS styles. I transform from DocBook to HTML (using the 
stylesheets) and from HTML to PDF with Prince (CSS for styles). I’m very 
impressed with the results.

www.princexml.comhttp://www.princexml.com


From: Bob Stayton [mailto:b...@sagehill.net]
Sent: Tuesday, January 24, 2012 10:40 AM
To: docbook-apps@lists.oasis-open.org; daniel.ke...@finaris.de
Subject: Re: [docbook-apps] Customizing and creating a stylesheet for docbook 
using the XML Mind or Oxygen XML Editor

Hi Daniel,
CSS has progressed to the point where it can format printed output, and I know 
of at least one product that can use CSS to generate PDF output (Antenna House 
XSL Formatter http://www.antennahouse.com/product.htm).  But most people use 
DocBook's XSL-FO output (fo/docbook.xsl) and an XSL-FO processor such as FOP to 
generate PDFs from DocBook content.

I believe someone pointed you to my online book DocBook XSL: The Complete Guide 
at http://www.sagehill.net/docbookxsl/index.html.  I believe it has the 
information you need to customize your PDF output.  This link will get you 
started with parameter setting:

http://www.sagehill.net/docbookxsl/PrintOutput.html

and this one with titlepage customization:

http://www.sagehill.net/docbookxsl/HTMLTitlePage.html

and this one will help with further customizations:

http://www.sagehill.net/docbookxsl/PrintCustomEx.html

Bob Stayton
Sagehill Enterprises
b...@sagehill.netmailto:b...@sagehill.net


- Original Message -
From: daniel.ke...@finaris.demailto:daniel.ke...@finaris.de
To: docbook-apps@lists.oasis-open.orgmailto:docbook-apps@lists.oasis-open.org
Sent: Monday, January 23, 2012 4:38 AM
Subject: Re: [docbook-apps] Customizing and creating a stylesheet for docbook 
using the XML Mind or Oxygen XML Editor

Hello,

sorry that it took so long, but I was quite busy.
Thanks for all the response - it made things easier for us.

The customization process is getting along pretty well, but we still have some 
questions regarding the PDF Output:

As said before, we customized Docbook to match our requirements. We basically 
added a few elements to the schema and blocked those we didn’t want. The font 
size etc. is determined by an css style sheet.

One problem is, that most of our new styles are not recognized if we output a 
document as a PDF. We already found the param.xml and pagesetup.xsl file, but 
were not sure if it is necessary to customize them as well. Did we go wrong 
using css instead of xsl as a stylesheet? Oxygen handles both, but it seems 
like only xls is supported for creating a PDF.

Another problem that we have is, that we can´t really figure out how to 
influence the general page layout (header, footer, graphic on the front page 
etc.). Is there any tutorial or something?

Finally, at least for now, we are wondering how to insert text boxes in line 
with the text, since in our current configuration text boxes are always 
inserted below the paragraph.



Thanks for the help and sorry if some questions might seem unnecessary. I´m not 
one of the XML guys in the company, but rather one of those who write and 
translate.

Greetings,

Daniel
From:

daniel.ke...@finaris.de

To:

docbook-apps@lists.oasis-open.org

Date:

17.01.2012 09:44

Subject:

[docbook-apps] Customizing and creating a stylesheet for docbook using the XML 
Mind or Oxygen XML Editor






Hello,

currently my company is thinking about transferring its user documentation into 
XML and docbook.
Since we are an IT company, XML and programming in general is not a problem. 
But: We cannot find and adjust the stylesheet needed to create our custom 
documentation.
We are currently setting up a prototype for our documentation, following the 
instructions from Walsh´s DocBook 5: The definitive Guide and working with 
the XML Mind Editor and a trial version of OXYGEN Editor.

Basically, we are satisfied with the results and trust in docbooks function 
(since having lots of trouble with Word), but the lacking transparency makes it 
really hard to come up with a sample documentation/ prototype .Each file we 
open has at least one reference to a website we cannot open and dozens of files 
that don´t exist or are really hard to find. We checked the regular docbook.zip 
from the docbook homepage, but also all  files of the respective editors. (Is 
there something as a default Docbook editor that you would propose?)

Can anyone give me some advice, a link or even a how-to for adjusting the 
docbook stylesheet? Personally, I would love to use docbook for our user 
documentation, simply for the additional features it has compared to other text 
processing program, but only if I can adjust the appearance. Especially 
regarding corporate identity this is absolutely necessary.

Thanks and with best regards,


D. Keyes




===
Disclaimer
The