Re: [docbook-apps] CV/Resume in DocBook?
Quoting [EMAIL PROTECTED] : Quoting W. Martin Borgert [EMAIL PROTECTED]: On 2008-09-23 10:11, Jacques Foucry wrote: I not really use Docbook for my CV but a resumé Library, in XML to : ... http://xmlresume.sourceforge.net/ I also happen to use DocBook and also xmlresume. And I like both a lot. But be warned: Active development of xmlresume stopped in 2004. The resp. help forum on sf.net is rather low-traffic, so don't expect to receive very much help from there. This is interesting. The XML looks really docbookish (e.g. para, emphasis, etc.). Don't betray yourself! That's a rather superficial similarity. Is should be possible to define this or something close as DocBook derivative, in the way of http://www.docbook.org/tdg5/en/html/ch05.html I want to discourage you from doing so for just a personal (life-time wasting) project. This is not to offend anybody, and also not to start a flame-war. I just think that starting a ch05 project (Customizing DocBook) is something you should start as a professional project -- e.g. in the environment of the company that feeds you. Btw. the PDF examples look - no offense - not very convincing. The look is a matter of stylesheet customization. I have successfully used a tweaked version of the xmlresume DTD and stylesheets, see the examples on this page: http://www.mhoenicka.de/about.html Right, Markus's PDF from his customized stylesheets looks nicer than the non-customized ones. But then: Markus's work is not really public, as far as I am aware of. Again: this is not to offend anybody. One of my bad experiences with xmlresume is, that the xslt scripts eat space (where you don't expect it) and also nbsp;, and I don't know how to fix it, and I am neither prepared nor willing to dig too deep at all into those xslt scripts. So right, xmlresume is a way to go, if you want to write your CV the XML way, but you are a little alone with that. I wonder, why there is actually no widely-know XML-stylesheet for writing letters, but maybe somebody will tell us. I personally use Content-Type: text/enriched (http://en.wikipedia.org/wiki/Enriched_text) for the gap between DocBook files and flat text files, and I edit that kind of documents using emacs, which has a dedicated mode for that. emacs creates PostScript for those documents, and ps2pdf helps me rendering PDF files from that. Of course, the output looks rather poor, but it's good enough for what I use it for. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
[docbook-apps] Re: blogging using DocBook articles or so ...
Grant Taylor writes: On 07/18/10 08:43, Jochen Hayek wrote: Would be exciting to use DocBook also for that. I have considered (and am in fact putting together pieces in my head) using DocBook in combination with some other things for something similar. Currently I am planning on using DocBook, Make (files), SSI and possibly a few other shell level things to manage a website / blog (if you will) for my self. In short, I'm trying to use (what I consider to be) the best tool for the job. Grant. . . . Well, pls, keep meus updated! J. - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
[docbook-apps] Re: blogging using DocBook articles or so ...
Dave Pawson writes: From the above, you can see that the html header from docbook is all redundant? Not from the above, but if I want to keep the article separate, then yes. I'm unsure what an atom feed reader would do with a link to docbook source in the body. Try it? Hmm, Dave, *come* *on*!! Pls! I mean, of course the link points to HTML content, not to literal DocBook content. Have a look at this feed e.g.: http://pragprog.com/feed/global Minimal content for each atom feed entry (or is it RSS?!?), just a pointer to the content, which is separate. By now I am also aware of Norm's Own Approach, pointed to by Maurith, see below! I assume, that's DocBook articles with the feed refering to the HTML content generated from DocBook. Whether it really is like that with Norm's Own Approach or not, I would like it like that, and that's where I would like to get. Separate articles, each written in DocBook, atom being the wrapper pointing to articles living for themselves, one by one. Hand craft a feed and see what bloglines or something does with it before you go further. HTH regards Dave Pawson XSLT XSL-FO FAQ. http://www.dpawson.co.uk Thanks for your patience and for your offer as well! J. MJ == Mauritz Jeanson m...@johanneberg.com writes: MJ Norman Walsh writes his blog in (a customization of) DocBook: MJ http://norman.walsh.name/ MJ Here is an old (obsolete?) article describing the machinery: MJ http://norman.walsh.name/2003/05/14/how MJ Mauritz - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
[docbook-apps] Re: blogging using DocBook articles or so ...
MJ == Mauritz Jeanson m...@johanneberg.com writes: MJ Norman Walsh writes his blog in (a customization of) DocBook: MJ http://norman.walsh.name/ MJ Here is an old (obsolete?) article describing the machinery: MJ http://norman.walsh.name/2003/05/14/how MJ Mauritz I really like this approach. But it needs a web server of your own, if I understand Norm's explanations correctly. Alright, I have been on my way to my own Linux in the Cloud for a while anyway! Once that's sorted, I think, this is my route! Thanks for the pointer! J. - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
[docbook-apps] Re: blogging using DocBook articles or so ...
Remko Tronçon writes: … maybe there has already been an attempt to use DocBook for blogging? FWIW, I created a stylesheet for integrating DocBook documents with the WordPress blogging platform: http://el-tramo.be/blog/integrating-docbook-with-wordpress I downloaded your docbook-kit-master.zip, and I like especially its size, I mean how small it seems to be. small is beautiful in that respect. But just like Norm's Own Approach you need an entire web-server and so forth for yourself. I would still love to run a script over all (DocBook) articles located on my disk in one directory or so, let it assume, there is already HTML generated and uploaded for all of them, create RSS resp. ATOM, upload that to a public place. As simple as that. Unreasonable? Undoable? I don't really use it for blogging, though, only for integrating my DocBook articles in my webpage. Moving from dynamic blogs to 'static' blogs has gained some popularity recently, with projects like Jekyll being used a lot. These projects use Textile, Markdown, etc. wiki-like syntax as input formats, but DocBook would work as well. So my approach isn't really to insane, I understand ;-) cheers, Remko - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
[docbook-apps] DocBook Website / the navigational ToC / internal vs. external links
There is no obvious or enforced difference there regarding internal vs. external links. I would like to see some kind of accepted or common use of how to mark up in whatever way *external* links. It does make a difference, whether to stay within that navigation system or to leave it through an external link. Any best practices? J. -- As nice as you guys here are, pls usually *only* reply to my post right on this mailing list. I honestly do follow this list. Of course, if you want to tell me, how silly I am, then let's keep that private ;-) but usually it's only my Bad Simple English, not my ideas. - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
[docbook-apps] sample DocBook Website anywhere?
Hi, there! I guess I'm blind, but I didn't find the sample web-site from docbook-website-2.6.0 installed in a proper public place. I thought, it would make sense being able to use that for demonstrational purposes. For the time being I put it on my own endless web space: http://aleph-soft.com/docbook-website-2.6.0-example/ Now you know, what I'm referring to, right? Be warned: I am going to remove it from there again sooner or later. I hope, someone will point me to *the right place* preferredly soon [?] , and I will rush removing my installation. Jochen, *another angry+rude Hun* 343.gif
[docbook-apps] Re: DocBook Website / the navigational ToC / internal vs. external links
I thought a little longer ... Maybe links to the outside world (configurably) always open in a separate window / tab. But there could still be a little marker ... Right, and that can be done within the document (in whatever way), but also within the code generators (aka stylesheets). Jochen Hayek writes: There is no obvious or enforced difference there regarding internal vs. external links. I would like to see some kind of accepted or common use of how to mark up in whatever way *external* links. It does make a difference, whether to stay within that navigation system or to leave it through an external link. Any best practices? J. - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
[docbook-apps] DocBook Website / style of the generated HTML
Tonight at the Berlin Mongers' Meeting I got my first feedback regarding my new web-sites, which I all set up using DocBook Website. The main critic was, that together with the nav. ToC (which I *love*) the code is too much style of early 200x years, too much HTML table based. I am really not into that, and I don't mind that, as long as it looks neat and works properly, *and* it's based on something I know and love and that I am quite familar with, which is DocBook. So is that a general and well-know critical view at the HTML generated from DocBook Website? Jochen Hayek, the rude+angry Hun ;-) http://Hayek.name - Jochen - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
[docbook-apps] Re: DocBook Website / style of the generated HTML
Sina K Heshmati s...@khakbaz.com writes: Jochen Hayek jochen+oasis-o...@hayek.name said: Sina K Heshmati writes: Jochen Hayek said: Sina K Heshmati writes: Jochen Hayek said: (2) Does is make sense, to let a designer improve the CSS for my purpose? It depends on what you mean by improving CSS. Achieving something as neat as BeagleBytes.com as opposed to the default Website. Could you not just grab the style [3] of that website and apply them to yours? I see, SinDoc, you are a rather smart guy!! That's exactly, what I planned to do short-term, actually I wanted to let that get done by a friend, but she is not as DocBook-minded as I am, so that looks a little difficult. Artist, a little main-stream web-designer, ... The CSS customization to this website doesn't seem to be very deep. I mean, the markup is the same table-rich HTML. If you want to generate a table-less HTML layout, given your DocBook Website source files and website layout, you might want to take a look at SilkPage [2]. I am personally not really in a hurry regarding table-less HTML. Did you not like the look-and-feel of SilkPage instances. FWIW, SilkPage has other themes too but they're not equally elaborate. The 'ala' XSL theme is the best, AFAIK. I read about SilkPage before, thank for the pointer anyway. But I decided to be patient and be focused on DocBook Website itself. (2) Will Website2 invalidate the CSS used for Website-2.6, because it changes structure and/or naming (conventions)? Yes, indeed! So investment in nicer (temporary) CSS should be rather restrictive. It depends on your preferences as to the final look-and-feel of your website. Once you define a target, then there will definitely be a reasonable solution that takes your toward your goal. Well, pointed out, dear friend! You earned yourself beer and pizza, if you ever make it to Berlin or if we meet anywhere else. Kind regards, SinDoc [3] http://www.beaglebytes.com/stylesheet.css Yes!!! Good man! Thanks for your response! How can we speed up the re-implementation? :-) Kind regards from Berlin, Jochen - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
[docbook-apps] Re: DocBook Website / style of the generated HTML
Sina K Heshmati writes: Jochen Hayek jochen+oasis-o...@hayek.name said: Sina K Heshmati s...@khakbaz.com writes: Jochen Hayek jochen+oasis-o...@hayek.name said: Sina K Heshmati writes: Jochen Hayek said: Sina K Heshmati writes: Jochen Hayek said: Thanks for the kind words, Jochen :) You guys here *are* very kind, so it's easy to be kind as well. How can we speed up the re-implementation? :-) The strategy is to develop a lightweight version first and add new features afterwards. This way, we'll be able to see for ourselves how the code grows along the way. Once the basic version is out, it would be interesting to receive feedback from both other developers and early users. I would be enlightened to get invited to be an early adopter, of course. Jochen, the rude+rough Hun - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
[docbook-apps] Re: html 5, as a target
Dave Pawson da...@dpawson.co.uk writes: Reading http://diveintohtml5.org/ and wondering if people think it would make a good target for docbook? Possibly as a replacement for html, more likely as a choice? Thoughts? Simply put: that would be awesome! - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
[docbook-apps] Re: DocBook Slides : a single quote character within title.*/title must get escaped in the Javascript for the nav. ToC ...
Mauritz Jeanson writes: | -Original Message- | From: Jochen Hayek | | Mauritz Jeanson writes: | | OK, now I understand (it would have helped | if you had said from the start | that you are using the dynamic ToC feature). | | didn't I? You did not say that you had set the dynamic.toc parameter to 1 (the default is 0). If you don't set this parameter you still get a TOC of course, but not a dynamic one. Well, I am always seeking perfection, often failing though! good grief! ;-) And true: you are DocBook-wise a couple of graduation levels above me, and that's good for me, right? :-) | would that be 1.75.1 ? | | or anything far newer than that? 1.75.2. Thanks, I am trying to get hold of that. | well, the single quote character problem is still alive and | kicking with 1.75.1, which I tried right now. That is strange. [...] Sorry, I recognized my fault right after sending off my response, but I hoped, before anybody (resp. exactly you) would see it, I would be able to give a complete statement, which I wasn't. Sorry for that. I owe you something. My new problems now look like this (namespacing...): xsltproc \ html/docbook.xsl \ slides.xml Writing frames.html for slides Writing toc.html for slides Element author in namespace '' encountered in authorgroup, but no template matches. Element firstname in namespace '' encountered in author, but no template matches. Element surname in namespace '' encountered in author, but no template matches. Element author in namespace '' encountered in authorgroup, but no template matches. Element firstname in namespace '' encountered in author, but no template matches. Element surname in namespace '' encountered in author, but no template matches. [...] You saw my sample slides.xml, didn't you? - http://Hayek.name/Jochen/tmp/docbook-slides-example--minimal.tar.gz What's wrong with it under namespacing conditions? Thank you very, very much!!! Jochen, the rough+rude Hun ;-) - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
[docbook-apps] Re: html 5, as a target
Jirka Kosek writes: Dave Pawson wrote: Structural markup would better match docbook semantics. You mean those new elements which are not working in IE6 IE7? http://blog.whatwg.org/supporting-new-elements-in-ie Generally a move forward from html 4. From markup point of view HTML5 is a mess. No grammar, no schema. HTML5 is step forward for web applications, but in some other directions it is step backward. We all appreciate your technical expertise, but from a marketing point of view, it's one of the biggest mistakes you or the DocBook community could make, if you said: we ignore HTML5. Would you agree? Jochen, the rough+rude Hun ;-) P.S. Me being a stubborn Darwinist,;-) I can only emphasize, that evolution is not always to the better. But it's sort of stupid to fight evolution, better join it, if that matters to evolution. - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
[docbook-apps] Re: html 5, as a target
Bob Stayton writes: When I go to the W3C website, I see that HTML5 is only in the stage of W3C Working Draft as of 24 June 2010. If we are going to implement support for HTML5, it should be on an experimental level, no? Right, but already for that working draft there are 2 neat books out there, and there are Google evangelists visiting the local Google Technology User Groups around the world, spreading the good word with the help of rather nice sandwiches, cookies, and lots of *free* beer;-) desperately ;-) attempting to make it happen rather sooner than later: HTML5: Up and Running http://oreilly.com/catalog/9780596806033 by Mark Pilgrim http://www.oreillynet.com/pub/au/2385 published by O'Reilly Media HTML5 and CSS3--Develop with Tomorrow's Standards Today http://www.pragprog.com/titles/bhh5/html5-and-css3 by Brian Hogan http://www.oreillynet.com/pub/au/3045 published by The Pragmatic Programmers (this book is still Beta, you can get a pre-print and ongoing PDF from them) Jochen, the rough+rude Hun ;-) - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
[docbook-apps] Re: what's the migration path from non-namespaced DocBook stylesheets to namespaced oneds?
Bob Stayton writes: Hi, I'm not quite clear what the question is here, but I think you are asking how to migrate a customization layer that was for the non-namespaced stylesheets to one that could be used with the namespaced stylesheets. Actually: no. I am sorry, should that disappoint you. Until the other day I processed my DocBook Slides documents with docbook-slides-3.4.0/xsl/html/frames.xsl Now I started attempting to process them using these stylesheets: /usr/share/xml/docbook/stylesheet/nwalsh5/1.75.1/slides/html/frames.xsl (Although ... the numbering scheme does confuse me.) Thanks a lot, Bob! Jochen, the rough+rude Hun ;-) - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
[docbook-apps] docbook-slides-3.4.0 vs. 1.75.1/slides
Until the other day I processed my DocBook Slides documents with docbook-slides-3.4.0/xsl/html/frames.xsl Now I started attempting to process them using these stylesheets: /usr/share/xml/docbook/stylesheet/nwalsh5/1.75.1/slides/html/frames.xsl (Although ... the numbering scheme does confuse me.) Hmmm, something's missing here, righ?!? Maybe a couple of messages from xsltproc? Here they are: xsltproc \ html/docbook.xsl \ slides.xml Writing frames.html for slides Writing toc.html for slides Element author in namespace '' encountered in authorgroup, but no template matches. Element firstname in namespace '' encountered in author, but no template matches. Element surname in namespace '' encountered in author, but no template matches. Element author in namespace '' encountered in authorgroup, but no template matches. Element firstname in namespace '' encountered in author, but no template matches. Element surname in namespace '' encountered in author, but no template matches. Element author in namespace '' encountered in authorgroup, but no template matches. Element firstname in namespace '' encountered in author, but no template matches. Element surname in namespace '' encountered in author, but no template matches. Element pubdate in namespace '' encountered in slidesinfo, but no template matches. Element legalnotice in namespace '' encountered in slidesinfo, but no template matches. Jochen, the rough+rude Hun ;-) - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
[docbook-apps] multi-lingual DocBook Website web-sites
Hi there! I created a couple of mono-lingual web-site using DocBook Website, and I personnally love them. Obviously an English web-site addressing a public in the German speaking countries, doesn't make too much sense, and maybe I should have started them in German right from the beginng, but I didn't want to. But I knew from the very beginnings of these web-sites, that I would want them multi-lingual sooner or later. So the multi-lingual refers to a couple of aspects, even not too seriously connected issues: 1.) With the currenty stylesheets to create HTML from DocBook Website documents: would it be possible to extractconvert parts of the documents labeled with the languages of respective parts of these documents *into* *separate* *HTML* *documents* and 2.) would it be possible to publically link these different HTML files to each other using e.g. the flags of the countries, where these languages are spoken most. Maybe you came across multi-lingual web-sites before, maybe you want to suggest a pragmatical way to deal with this sort of issue. Kind regards, Jochen Hayek - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
[docbook-apps] Re: multi-lingual DocBook Website web-sites
Jirka Kosek writes: Jochen Hayek wrote: So the multi-lingual refers to a couple of aspects, even not too seriously connected issues: 1.) With the currenty stylesheets to create HTML from DocBook Website documents: would it be possible to extractconvert parts of the documents labeled with the languages of respective parts of these documents *into* *separate* *HTML* *documents* This is possible using profiling feature of stylesheets. For web-site you have to use two-pass approach: http://www.sagehill.net/docbookxsl/Profiling.html Although I don't think that having both language versions in single file is a good approach for localization. It is better to have language versions in a separate files Alright, I started doing that, but actually I wanted to avoid that. Single source principle had looked nice to me for many years ;-( and use translation software with translation memory to maintain localizations. Definitely not, thanks for the advice anyway. Try googling, this was dicussed plenty of times in a past. and 2.) would it be possible to publically link these different HTML files to each other using e.g. the flags of the countries, where these languages are spoken most. You can customize XSLT stylesheets to emit additional links to other languages. That wasn't done anywhere so far? My xslt skills wait for slight improvements ... Many thanks for your response, Jirka!! Kind regards, Jochen - To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org