Re: [docbook-apps] CV/Resume in DocBook?

2008-10-06 Thread Jochen Hayek

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 ...

2010-07-21 Thread Jochen Hayek
 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 ...

2010-07-21 Thread Jochen Hayek
 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 ...

2010-07-21 Thread Jochen Hayek
 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 ...

2010-07-21 Thread Jochen Hayek
 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

2010-07-22 Thread Jochen Hayek
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?

2010-07-23 Thread Jochen Hayek
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

2010-07-23 Thread Jochen Hayek
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

2010-07-28 Thread Jochen Hayek
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

2010-08-03 Thread Jochen Hayek
 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

2010-08-03 Thread Jochen Hayek
 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

2010-08-14 Thread Jochen Hayek
 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 ...

2010-08-14 Thread Jochen Hayek
 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

2010-08-15 Thread Jochen Hayek
 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

2010-08-15 Thread Jochen Hayek
 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?

2010-08-15 Thread Jochen Hayek
 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

2010-08-15 Thread Jochen Hayek
 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

2010-08-17 Thread Jochen Hayek
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

2010-08-24 Thread Jochen Hayek
 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