Thread overview
Amost perfect
Sep 30, 2005
Bob W
Sep 30, 2005
Walter Bright
Sep 30, 2005
Derek Parnell
Sep 30, 2005
Walter Bright
Sep 30, 2005
Bob W
September 30, 2005
Hi Walter,

if you add one tag to "std_math.html" you'll have
your first and only page which is valid HTML 4.01.

I am talking about the 'dmd.134.zip' docs, not your
web pages, where 'std_math' and 'style.css' look
like they are still the previous versions.

In order to get rid of the last flaw in the new
"std_math.html" you just need to change the
following section from:

    <h1 align=center>std.math</h1>

    <dl>
    <!-- Generated by Ddoc from std\math.d -->

    <dl><dt><big>const real <u>E</u>;

to:

    <h1 align=center>std.math</h1>

    <dl><!-- either 'dd' or 'dt' is required... -->
    <dd><!-- ...before opening the next 'dl' tag. -->
    <!-- Generated by Ddoc from std\math.d -->

    <dl><dt><big>const real <u>E</u>;

and you are done.


Not that this would make a big difference, because
you'd currently get a couple of thousand validation
errors on the rest of your HTML files.

If you are planning to keep the basic layout of the
HTML files, then you'd need about 4 templates to
base on, which are featuring different menus (toc)
but share the same principles.

At this present moment you are using various
methods on different pages to display the same
kind of stuff, which could make maintaining them
a bit time consuming, right?

I am also curious to know if you plan to keep
your 3 XHTML pages, while the rest of them is
HTML?



September 30, 2005
"Bob W" <nospam@aol.com> wrote in message news:dhi8ok$hci$1@digitaldaemon.com...
> I am talking about the 'dmd.134.zip' docs, not your
> web pages, where 'std_math' and 'style.css' look
> like they are still the previous versions.

That's because I haven't uploaded the new ones.

> In order to get rid of the last flaw in the new
> "std_math.html" you just need to change the
> following section from:
>
>     <h1 align=center>std.math</h1>
>
>     <dl>
>     <!-- Generated by Ddoc from std\math.d -->
>
>     <dl><dt><big>const real <u>E</u>;
>
> to:
>
>     <h1 align=center>std.math</h1>
>
>     <dl><!-- either 'dd' or 'dt' is required... -->
>     <dd><!-- ...before opening the next 'dl' tag. -->
>     <!-- Generated by Ddoc from std\math.d -->
>
>     <dl><dt><big>const real <u>E</u>;
>
> and you are done.

Ok. Didn't know that one must have dd or dt following dl.

> Not that this would make a big difference, because
> you'd currently get a couple of thousand validation
> errors on the rest of your HTML files.

I'm not worried about that, as I plan to replace them all with Ddoc generated files, which will be correct.

> If you are planning to keep the basic layout of the
> HTML files, then you'd need about 4 templates to
> base on, which are featuring different menus (toc)
> but share the same principles.

Yes.

> At this present moment you are using various
> methods on different pages to display the same
> kind of stuff, which could make maintaining them
> a bit time consuming, right?

Right, but I don't intend to maintain them. I intend to replace them all with Ddoc.

> I am also curious to know if you plan to keep
> your 3 XHTML pages, while the rest of them is
> HTML?

Those were provided by others here to help me learn what XHTML is all about.

So, at this point, the evil plan is to get Ddoc to generate 100% correct HTML, then convert the documentation to using Ddoc, and then write Ddoc template files for XHTML.


September 30, 2005
On Thu, 29 Sep 2005 21:21:57 -0700, Walter Bright wrote:


[snip]
> So, at this point, the evil plan is to get Ddoc to generate 100% correct HTML, then convert the documentation to using Ddoc, and then write Ddoc template files for XHTML.

Nice plan. Then we can work on the content ;-)

-- 
Derek
(skype: derek.j.parnell)
Melbourne, Australia
30/09/2005 2:58:57 PM
September 30, 2005
"Derek Parnell" <derek@psych.ward> wrote in message news:1xlehgu6lhkhz.1mlnr3cr86bdd$.dlg@40tude.net...
> On Thu, 29 Sep 2005 21:21:57 -0700, Walter Bright wrote:
>
>
> [snip]
> > So, at this point, the evil plan is to get Ddoc to generate 100% correct HTML, then convert the documentation to using Ddoc, and then write Ddoc template files for XHTML.
>
> Nice plan. Then we can work on the content ;-)

Mucking about with the formatting on the documentation takes at least half the time, so I'm hoping that Ddoc will make it much, much easier to generate good looking documentation.

What also happens is that people will improve a couple of the documentation pages and send them to me. They are an improvement, but then I'm faced with editting in all those changes to scores of files. With Ddoc, all they need to send me is a style sheet or a template file, and voila!



September 30, 2005
>> .....
>> and you are done.
>
> Ok. Didn't know that one must have dd or dt following dl.

It is like TABLE. You would not attempt to put any
contents there before using TD. Just that it doesn't
matter much in the case of DL, because most browsers
will probably do what you'd expect them to do. I just
wanted to have mentioned this before Ddoc starts
generating working but illegal markup code.



>> Not that this would make a big difference, because
>> you'd currently get a couple of thousand validation
>> errors on the rest of your HTML files.
>
> I'm not worried about that, as I plan to replace them all with Ddoc generated files, which will be correct.

I am not too concerned about that as well. You are
in good company: Even if you don't change a thing
you will still beat major internet players like
Google, Yahoo and Cnet in terms of HTML conformance
on their home pages.
(Also note: none of them is using XHTML.)



>> At this present moment you are using various
>> methods on different pages to display the same
>> kind of stuff, which could make maintaining them
>> a bit time consuming, right?
>
> Right, but I don't intend to maintain them. I intend
> to replace them all with Ddoc.

Good move anyway, eagerly awaiting the results ...



>> I am also curious to know if you plan to keep
>> your 3 XHTML pages, while the rest of them is
>> HTML?
>
> Those were provided by others here to help me learn what XHTML is all about.
>
> So, at this point, the evil plan is to get Ddoc to generate 100% correct HTML, then convert the documentation to using Ddoc, and then write Ddoc template files for XHTML.

Although I am using XHTML from time to time, I fail to
get fully convinced about its benefits for general apps.
(Some guys in the beforementioned companies - Google,
Yahoo and Cnet, etc. seem to have similar thoughts).
But I would probably still go ahead and try to let Ddoc
generate XHTML (just for reputation rather than functionality).
But if I saw the slightest problem arising I would instantly
revert back to HTML 4.01 Transitional and would feel
safe until 2015 or so.

Just an early warning to Ddoc: XHTML 2.0 (work in progress)
is designed NOT to be backwards compatible to XHTML 1.0
and XHTML 1.1.