Forums / Developer / Contributed documentation problem

Contributed documentation problem

Author Message

Paul Forsyth

Thursday 27 March 2003 5:48:57 am

Ive been trying to edit the article:

http://ez.no/developer/ez_publish_3/documentation/ez_publish_3/howtos/getting_the_latest_ezpublish_source

but am having problems with the xml text field. not sure if its something odd happening with my browser cache or theres perhaps a clash going on with the stylesheets used for the page or with the data field itself...

The first funny is the initial heading value for 'Install'. When i edit it is set to 1. This turns out to be a regular sized heading, which is blue. I change the value to 2, which is what the other headings are set, which are black, to but find after I post that the value has reverted back to 1... Looking at the source it seems a heading value of 1 is actually a h2 and 2 is h3.

Im not clear on how to get proper spaces working with the literal tag. The gap from the text above it seems to large. Is there a way to position better from within a xml data field?

Have a look and see what you can do with the article. Im a little stumped.

Paul

Jan Borsodi

Thursday 03 April 2003 3:02:01 am

The XML format is designed with content in mind, this means that there is no direct mapping between an XML header and an HTML header. Our default templates has this but on ez.no for instance the <h2> tag is used for header level 1.
If you wanted you could render level 1 as bold, level 2 as italic and level 3 with texttoimage.

This also means that you cannot skip levels, ie going from 1 to 3.

When writing documentation you should think about the structure of the document instead of it's appearance.

If you feel that the current setup of the tags leaves too much space then ofcourse we can adjust that.

--
Amos

Documentation: http://ez.no/ez_publish/documentation
FAQ: http://ez.no/ez_publish/documentation/faq

krish harry

Monday 26 May 2003 11:02:20 am

Why skipping one level is not possible? If we directly want to use <h3> in the heads why we have to use <h1> and <h2> also in the document? Or have i misunderstood?

Karsten Jennissen

Monday 26 May 2003 11:55:59 pm

I think that's XHTML standard. First use h1, then h2, then h3.

Paul Borgermans

Tuesday 27 May 2003 1:41:51 am

For this discussion, xhtml is just html xml-ized. What Jan means is that <header level=xx> is used to structure your text-writing, not formatting/layout.

Lots of people have difficulties to adapt to the idea of separation between content and presentation. Me too sometimes.

On the other hand, I think specifying a level=2 to start should be possible for certain situations like when having multiple articles forming a larger structure (book-like). That really makes sense to me. Any thoughts from the ez team on this?

Paul

eZ Publish, eZ Find, Solr expert consulting and training
http://twitter.com/paulborgermans

krish harry

Saturday 14 June 2003 5:31:27 am

>The XML format is designed with content in mind, this means that there is
>no direct mapping between an XML header and an HTML header. Our
>default templates has this but on ez.no for instance the <h2> tag is used
>for header level 1.

How to map <h2> to header level 1 like you are doing above? I tried but did not find the required setting file.

Tx.
Krish

Paul Borgermans

Sunday 15 June 2003 1:11:43 am

You should look in

design/standard/templates/content/datatype/view/ezxmltags/header.tpl

Changes are best performed in your own design/<siteaccess>/override directory structure of course

--paul

eZ Publish, eZ Find, Solr expert consulting and training
http://twitter.com/paulborgermans