Re: [docbook] Status attribute
On 04/14/2013 06:26 PM, Thomas Schraitle wrote: > Hi Togan, > > Am Sonntag, 14. April 2013, 16:39:24 schrieb Togan Muftuoglu: >> [...] >> The document I am trying to fix is a badly formatted usermanual, which >> in the beginning was not even validating. It was full with sectX >> elements which included informaltables to create definitions for various >> terminology used by the software. These sectX had status either set as >> draft or final. > > Ok, I see. However, I still don't know what you want to do with this > information. :) when producing the fo output only use those that are for final or draft with the use of profiling xsl paramater > > >> I have now converted such sectX to variablelists and get rid of the >> informaltable definitions. However I can't make any attributions to >> these variablelists if they are meant to be draft or final as with the >> profiling of status I am able to produce a final output. > > By the way, just as an additional information: If you need/want to transform > your original document again, you can do it with XSLT. I've written a topic > about transforming a sectX element into a section. This is not entirely your > use case, but with some (small?) modification you can avoid manual editing: > > http://doccookbook.sf.net/html/en/dbc.structure.sectX-to-section.html I know as I have used it ;) That is a great source for ideas and implementations. Keep the great job > > Marking up an element with @status, @revision, @condition (or whatever you > use) is one side of the coin. The other side is what you want to do with this > information. > > Usually I value consistency, but in this case I wouldn't recommend to replace > all status attributes. The @status attribute influences how a document is > shown. For example, setting status to "draft" and the parameter $draft.mode > to > "yes" will use a background image (which is taken from > $draft.watermark.image). Yes I know but that is not what I want, the manual includes final for status for sections that are proofread and draft for those that are not reviewed. So I am not using draft.mode parameter but profile.status with final in the customized stylesheet > > This is already implemented in the DocBook stylesheets. You get this > behaviour > for free, if you marked up your division elements with status. This may or > may > not what you want. The question is, how you want to show other elements > containing your former status attribute (which is now a condition or > revision). Once I decide the attribute all former status is gone for good, so there is one thing to consider Thanks Togan - To unsubscribe, e-mail: docbook-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-h...@lists.oasis-open.org
Re: [docbook] Status attribute
Hi Thomas, On 04/14/2013 02:07 PM, Thomas Schraitle wrote: > > Right, status is only allowed on division elements like book, chapter, etc. > > Is there a special reason why you need it in a variablelist and not on its > division parent element? I'm not sure if I understand your user case. The document I am trying to fix is a badly formatted usermanual, which in the beginning was not even validating. It was full with sectX elements which included informaltables to create definitions for various terminology used by the software. These sectX had status either set as draft or final. I have now converted such sectX to variablelists and get rid of the informaltable definitions. However I can't make any attributions to these variablelists if they are meant to be draft or final as with the profiling of status I am able to produce a final output. Hence is my problem. > > Usually, a variablelist is not published separatly, it's normally embedded > inside a section, a chapter, or a book. This parent element can have a status > attribute which "derives" its status to all its child elements. > Adding a status attribute only on a variablelist doesn't make sense to me. > > The closest attribute to status may be a revision or condition attribute, > which are allowed on very element. Hmm, never have thought about it in this sense, however it should work just need to convert all other status attributes to one of these to achieve consistency Thanks - To unsubscribe, e-mail: docbook-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-h...@lists.oasis-open.org
[docbook] Status attribute
Hi, I have a document where I use status for "draft" or "final" phase of the document. However status attribute is not one of the common attributes, hence I cannot use this attribute in variablelist or term elements (just to name a few, as I am sure there are other cases as well). Would it be possible to include status attribute in common attributes ? Thanks Togan - To unsubscribe, e-mail: docbook-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-h...@lists.oasis-open.org
Re: DOCBOOK: example of docbook for FAQ?
* Joseph Panico; <[EMAIL PROTECTED]> on 01 Dec, 2002 wrote: Could someone point me to a docbook markup for producing nice looking FAQs? The kinds with TOC/index. Any pointers appreciated. I use docbook for the Unofficial SuSEFAQ project nad basicly I have it as a book with qandaentries in sections http://susefaq.sourceforge.net Also I have some articles along with the same project which are using Website DTD http://susefaq.sourceforge.net/articles/ HTH -- Togan Muftuoglu
Re: DOCBOOK: Re: Markup for exercises
* Norman Walsh; <[EMAIL PROTECTED]> on 16 Oct, 2002 wrote: >| Objective in my opionion is a higher level element. >| >| >| >| >| >| >| < >| > >"Module" has awfully wide and varied connotations. What are you >suggesting here? How does it relate to the 'exercise' markup discussion? Well if I remember correctly the whole thread started with the possibility of creating manuals for the Teacher and the Student. If I am writing a manual for teaching use then there are modules for each session. Every module has "objectives " to be covered in the session and then during the session there are exerceises (Self tests). Once the module is done then there can be Knowledge Reviews and Quizzes. While Knowledge Reviews are self study quiz/exam are not. In Performance base teaching "Objectives" are vital in preparing the Content and the Questions (for exercies/Knowledge Reviews/Quizzes exams). So my point is "Objective" should be a higher element ( should not be nested in Exercise ) Module can be named anything on the top level. For example Chapter is what I use for Modules currently. By saying "Module" I was not trying to ask for addition of a new element. I just want "Objective" to be a higher element not stuck within the "exercise" based on my understanding of "Performance Based Learning" Hope I made myself clear this time Thanks -- Togan Muftuoglu
Re: DOCBOOK: Re: Markup for exercises
* Norman Walsh; <[EMAIL PROTECTED]> on 16 Oct, 2002 wrote: >I'm personally quite unhappy with this proposal as it's written. It me too with what I see below :-) >adds five fairly general sounding element names (setup, scenario, >task, objective, and solution) in a fairly narrow context. Experience >suggests that this is too specific; it will work for some people, but >it will spawn frequent requests for more flexibility and new >special-purpose elements. Objective in my opionion is a higher level element. < . ... Setup... Scenario... Task Solution How this sound to you ? -- Togan Muftuoglu
Re: DOCBOOK: Re: Markup for exercises
* Joachim Ziegler; <[EMAIL PROTECTED]> on 12 Oct, 2002 wrote: This structure makes complete sense to me. The term is much better than . In an you can also say "Answer the following questions" and than just use an OrderedList. And so you can do in the corresponding . I would not use " Answer the following questions" as this is what do you want the student/reader to do/behave objective is a reacheable goal and it should be somewhere in <*_info> tag. -- Togan Muftuoglu
Re: DOCBOOK: Re: Markup for exercises
* [EMAIL PROTECTED]; <[EMAIL PROTECTED]> on 11 Oct, 2002 wrote: >I tend to agree. Such a structure would be useful to me too. So far yes > >Perhaps these might be useful? (or something similar)... Yes but every lesson (call it module/section whatever) should also have performance requirements (objectives). The way I am thinking is you have objective (perfomance requirement) which is explained in the following paragraph(s) and then you have exercise ( Self assesment) which I agree with the format below Normally Performance Requirements are also questions (though you can pharse them as sentences as long as they are measurable and clear yet this was an old approach) ie. What are the commonly used XSLT tools ? bla bla bla > > > ...as in sectioninfo... > ...information on what is needed to setup the exercise, >student data etc... > ... > ... > ... > My reasoning is if Docboook tags will be extended to include the above then the metodlogy of performance based learning should be included ( objectives) also Hope I did not make it an extra step -- Togan Muftuoglu
Re: DOCBOOK: Re: number continuation with orderedlist
* Norman Walsh; <[EMAIL PROTECTED]> on 02 Oct, 2002 wrote: >| 2 FW_MASQ >| bla bla >| > >Fixed. CVS checkin imminent. Thanks I did get the fo/lists.xsl from the sourceforge CVS but now when I am parsing it here is what I am getting. Any ideas ? /sbin/parser.sh firewall2.fo firewall2.xml article.xsl Error at xsl:call-template on line 167 of file:/home/toganm/devel/docbook/docbook-xsl-1.55.0/fo/lists.xsl: No template exists named orderedlist-item-number Transformation failed: Failed to compile stylesheet. 1 error detected. ps. I know this question belongs to the docbook-apps now but since it started on this list I continued. -- Togan Muftuoglu
Re: DOCBOOK: number continuation with orderedlist
* David Cramer; <[EMAIL PROTECTED]> on 01 Oct, 2002 wrote: >Greping in the 1.55.0 xsls, I notice there's a test for the continuation >attribute in the html xsls: >html/lists.xsl: >...but not in the fo xsls. Looks like a feature implemented in html, but >not yet in fo. I'd suggest submitting a feature request: >http://sourceforge.net/tracker/?func=add&group_id=21935&atid=373750 done Thanks I was so sure that it would do it I had not even consider checking the lists.xsl. Looks like rather rereading the TDG for the simple does not solve everycase :-( -- Togan Muftuoglu
DOCBOOK: number continuation with orderedlist
Hi, I am trying to have an output basicly like this Interfaces 1. FW_DEV_EXT bla bla bla 2. FW_DEV_INT bla bla bla 3. FW_DEV_DMZ bla bla bla Routing and Masquearding 4 FW_ROUTE bla bla bla 5 FW_MASQ bla bla However the produced output is joking at me Interfaces 1. FW_DEV_EXT bla bla bla 2. FW_DEV_INT bla bla bla 3. FW_DEV_DMZ bla bla bla Routing and Masquearding 1 FW_ROUTE bla bla bla 2 FW_MASQ bla bla Below is the source what am I doing wrong. Thanks -- Togan Muftuoglu Interfaces FW_DEV_EXT Which is the interface that points to the internet/untrusted networks? If you have more then one device connected to the Internet you can have multiple definitions ie. ppp+, ippp0, eth0 entered spearted by a space FW_DEV_EXT="ppp+ ippp0 eth0" FW_DEV_INT Which is the interface that points to the internal network? FW_DEV_DMZ Which is the interface that points to the dmz or dialup network? Routing and Masquerading FW_ROUTE FW_MASQUERADE FW_MASQ_DEV FW_MASQ_NETS
Re: DOCBOOK: re: converting to DocBook
* jonathon; <[EMAIL PROTECTED]> on 14 Aug, 2002 wrote: > >>If I had that problem, I would convert as many of them as I could to HTML, run >'tidy' to clean up the HTML, >>and then run the DocParse tool from www.commmandprompt.com to convert them to >DocBook. > > That sounds like the easiest option, since the majority of them are > in HTML format. Tidy can get everything to the same version of HTML. > > Somewhere I have a perl script that converts plain ASCII to HTML > 2.0. Tidy can clean up and upgrade the results to 4.01. > > Most of the formatted non-HTML, non-plain ASCII documents can be > converted to HTML using whatever created them in that format. > > There is the irony of converting to HTML, then to DocBook, then back > to HTML so that it can be seen on the web. > http://docbook.org/wiki/moin.cgi/Html2DocBook explains that HTML should be converted to XHTML (which is xml) and then applying a stylesheet given on the webpage xonvert XHTML to Docbook. HTH -- Togan Muftuoglu
Re: DOCBOOK: problems compiling docbook XML and stylesheet
* root; <[EMAIL PROTECTED]> on 30 Jun, 2002 wrote: >Hello, > >herewith output textfiles with errors upon make. >Any tip ? >My Linux is 2.4.19pre8 and distro SuSE8.0 which got the SGML version not the >XML > why don't you install as RPM from ftp.suse.com/pub/pepole/ke where you can find uptodate XSL versions ? -- Togan Muftuoglu
Re: DOCBOOK: Re: Announce: Updated The Definitive Guide published
* Norman Walsh; <[EMAIL PROTECTED]> on 11 Jun, 2002 wrote: >/ Togan Muftuoglu <[EMAIL PROTECTED]> was heard to say: > >Trackers for all bugs, please. My memory is overflowing. > >| Will you be adding the derivates of Docbook ie Slides, Website. Thanks > >I hadn't committed to doing that, but it sounds like a good idea. A tracker >for each, please :-) > Himm either sourceforge has problems or I have network problems as I can not commit the tracker request will try latter. -- Togan Muftuoglu
Re: Announce: Updated DocBook: The Definitive Guide published
* Norman Walsh; <[EMAIL PROTECTED]> on 11 Jun, 2002 wrote: >This version is built off the CR3 document type. > >Also: updated the reference pages for imageobject, tweaked navigation, >rebuilt the example see-also lists, added refentryinfo to all the >reference pages, and incorporated a number of other small fixes. Shall I add a tracker for the updates of Languages supported or you have that already in your agenda. Will you be adding the derivates of Docbook ie Slides, Website. Thanks -- Togan Muftuoglu
Re: DOCBOOK: height border attributes in imagedata
* Bob Stayton; <[EMAIL PROTECTED]> on 04 Mar, 2002 wrote: >On Mon, Mar 04, 2002 at 08:02:41PM +0200, Togan Muftuoglu wrote: >2. Replace SourceForge Logo with >SourceForge Logo >inside the . > >3. Bookmark this reference: >"DocBook: The Definitive Guide" >http://docbook.org/tdg/en/html/docbook.html >so you can look these up. 8^) I have the the bookmark what made me confused I guess "Learning XML" from Oreilly with Xlink and other stuff. Any way thanks for the help > >-- > >Bob Stayton 400 Encinal Street >Publications Architect Santa Cruz, CA 95060 >Technical Publications voice: (831) 427-7796 >Caldera International, Inc. fax: (831) 429-1887 > email: [EMAIL PROTECTED] -- Togan Muftuoglu
DOCBOOK: height border attributes in imagedata
Hi, How can I use the attributes *height* *border* and *alt* in This is what I want to insert in to the HTML http://sourceforge.net";> http://sourceforge.net/sflogo.php?group_id=42064"; width="210" height="62" border="0" alt="SourceForge Logo"> This is what I thought would solve my problem yet nsgml complains there are no attributes height and border :-( How do I tag it ? http://sourceforge.net";>http://sourceforge.net http://sourceforge.net/sflogo.php?group_id=42064"; width="210" height="62" border="0"/> SourceForge Logo -- Togan Muftuoglu Unofficial SuSE FAQ Maintainer http://dinamizm.ath.cx
Re: DOCBOOK: Adding metainfo to more places
* Norman Walsh; <[EMAIL PROTECTED]> on 15 Jan, 2002 wrote: > orderedlist, procedure, qandadiv, qandaentry, qandaset, table, > variablelist So if I understood correctly, say would be possible in qandaentry (hint I need this badly). > > Our plan of record is to add a single new *info element (and not > EquationInfo, ExampleInfo, etc.). Suggestions for the name of this > single info element are also solicited. DocInfo (Document Info) -- Togan Muftuoglu
DOCBOOK: Using Keywords in Qandaentry
Hi, I am trying to come with a FAQ and basicly what I want is to be able to use the in the qandadiv area so that I can put .htpsswd in the related area. How can I do it ? blabla bla bla Apache Zope Roxen Web Servers Apache &apache1; &apache2; &apache3; -- Togan Muftuoglu
Re: DOCBOOK: including driver file ... db2html -d
* G.L. Grobe; <[EMAIL PROTECTED]> on 14 Oct, 2001 wrote: > One more bit of help, it was suggested to me that I use: >'db2html -d myown.dsl myDocbookFile.sgm' > to use my own defines in the *.dsl file. But my db2html doesn't accept this. in my system it says -s --style FILE use file as driver STYLE -- Togan Muftuoglu To subscribe or unsubscribe from this elist use the subscription manager: <http://lists.oasis-open.org/ob/adm.pl>
Re: DOCBOOK: Troubles with PSGML-Mode in Xemacs
* Sorin Marti; <[EMAIL PROTECTED]> on 09 Oct, 2001 wrote: > I use SuSe Linux 7.1, xemacs v. 21.1.12... > > I hope someone can help me (and sorry for the terrible English) > have a look at www.suse.de/~ke/sgml as Karl has the source rpms and binary rpms for psgml 1.2.2 Although they are originally for 7.2 I can confirm that they did work under SuSE 7.1 also try adding (load "suse-start-psgml") in your .emacs file HTH -- Togan Muftuoglu To subscribe or unsubscribe from this elist use the subscription manager: <http://lists.oasis-open.org/ob/adm.pl>
Re: DOCBOOK: Corrupt PDF
* Fredrik Eriksson; <[EMAIL PROTECTED]> on 19 Sep, 2001 wrote: > I use the defaulty configuration of docbook that comes with Debian and when > I generate a PDF document using db2pdf I do not get any error messages. But > opening the document in Acrobat 5 then complains about that the PDF is > corrupt. Anybody else having this problem? > Same here while using SuSE I ended up using db2ps and then ps2pdf. -- Togan Muftuoglu To subscribe or unsubscribe from this elist use the subscription manager: <http://lists.oasis-open.org/ob/adm.pl>
DOCBOOK: writing man pages with refentry element
Hi, I am trying to write a man page with the refentry element. I have a question on how to write the description of the optional parameters for example -a this option enables bla bla -b enables this and that I though of using variablelist or table but I am not sure which one suits inuse for man pages. Any suggestions will be helpfull -- Togan Muftuoglu To subscribe or unsubscribe from this elist use the subscription manager: <http://lists.oasis-open.org/ob/adm.pl>
DOCBOOK: substeps are not numbering
Hi, I have defined procedure which has steps and substeps however substeps are coming as a b c d where as the explanation at http://docbook.org/tdg/en/html/substeps.html says " Processing expectations Formatted as a displayed block. SubSteps are almost always numbered. " I am using docbook V4.1 with dsssl 1.72 is this something I can refigure somewhere or ? TIA. -- Togan Muftuoglu To subscribe or unsubscribe from this elist use the subscription manager: <http://lists.oasis-open.org/ob/adm.pl>
DOCBOOK: variablelist
Hi, Is it possible to use variablelist in the variablelist tag or is there something else this is what I want ABC: bla bla DEF: bla bla GH bla bla Some word bla bla bla New word bla bla Another word bla bla TIA -- Togan Muftuoglu To subscribe or unsubscribe from this elist use the subscription manager: <http://lists.oasis-open.org/ob/adm.pl>