ANN: make-doc-pro-104 released
[1/4] from: robert:muench:robertmuench at: 31-Jul-2002 12:46
Hi, a new version of make-doc-pro is available from my homepage or thru
my rebsite. The biggest change is that MDP will now emit XHTML
Trainsitional. A lof of bugs fixed that have been reported to me. Thanks
again to all who helped to make MDP better.
I hope you like it and let me know if there are problems.
--
Robert M. M=FCnch
IT & Management Freelancer
Mobile: +49 (0)177 2452 802
Fax : +49 (0)721 8408 9112
Web : http://www.robertmuench.de
[2/4] from: anton:lexicon at: 1-Aug-2002 5:21
Hooray! Halt is now conditional on debug_mode ! :)
But, you are keeping the same version number, 1.0.4, why?
A quick test seems to work well.
Robert, you could maybe include a link to a xhtml validator
at the bottom of the generated page, if that's possible.
Maybe you can POST it? I might have a look tomorrow.
See code below for an example of how I create a source
file for documents. Just do the file, the html is regenerated
and browsed to automatically (very useful while writing docs):
do %make-doc-pro-example.r
And you can copy the code into each new document you create
without changes. Just remember to keep File in the header
the same as the filename.
You can also see a system I thought of recently for helping to
ensure that external code remains working in the future;
that is, putting a copy of other people's code in the "freezer".
I created a directory on my rebsite, %freezer/, where I put
a copy of code that is being updated frequently by the author
(in this case, Robert). It's like a "mirror", except it does not
aim to stay up to date with the latest file. It is simply there,
frozen
, so I've got control over when it changes.
That way, I can be sure that my docs & code that use it will
continue to work.
It's maybe not such a problem for more "dynamic" programmers than
me, with code floating around the swirling vortex of high-action
speed-programming, but I like everything to have its proper
place.
Anton.
> Hi, a new version of make-doc-pro is available from my homepage or thru
> my rebsite. The biggest change is that MDP will now emit XHTML
<<quoted lines omitted: 3>>
> --
> Robert M. Münch
----------- begin file %make-doc-pro-example.r ---------------
An example of how to automate MakeDocPro.
===Introduction
Hello, here is some code
code
###
[
rebol [
File: %make-doc-pro-example.r
]
; create + view html
do/args path-thru http://www.robertmuench.de/make-doc-pro.r (clean-path
system/script/header/file)
;read-thru mdp: http://www.lexicon.net/anton/rebol/freezer/make-doc-pro.r ;
get it into the cache
;do/args path-thru mdp (clean-path system/script/header/file)
file.html: head change find/last copy system/script/header/file ".r"
.html
browse join file.html "" ;"#sect3"
]
---------------- end file ----------------------------
[3/4] from: robert:muench:robertmuench at: 1-Aug-2002 11:33
> -----Original Message-----
> From: [rebol-bounce--rebol--com] [mailto:[rebol-bounce--rebol--com]]
<<quoted lines omitted: 3>>
> Subject: [REBOL] Re: ANN: make-doc-pro-104 released
> Hooray! Halt is now conditional on debug_mode ! :)
Hi, yep time will solve most problems ;-)).
> But, you are keeping the same version number, 1.0.4, why?
All the other versions were not offical release, these were
test-versions. So I keep the version number the same.
> A quick test seems to work well.
Great!
> Robert, you could maybe include a link to a xhtml validator
> at the bottom of the generated page, if that's possible.
Yes, why not. I just want to keep the footer as small as possible. How
about adding a link to the W3C validator for the XHTML text?
> Maybe you can POST it? I might have a look tomorrow.
POST what? The generated page? Hmmm... That would be nice.
> See code below for an example of how I create a source
> file for documents. Just do the file, the html is regenerated
> and browsed to automatically (very useful while writing docs):
> ...
Nice idea :-). So the docs become itself executable. It remembers me of
the SOM concept once propageted by IBM, where a document contained the
code (or references to code) for editing the document. But you just
passed around the document not the editor.
What I'm going to try out with /Link is to install MDP as a sevice and
give source documents the extension .mdp clicking on such a file will
tranform it into HTML and let you view it immediatly.
> You can also see a system I thought of recently for helping
> to ensure that external code remains working in the future;
Good idea. I try to keep MDP as compatible as possible and of course
always have a workable version at my web-site.
Thanks for the feedback. Robert
[4/4] from: emptyhead::home::nl at: 1-Aug-2002 12:40
> Robert, you could maybe include a link to a xhtml validator
> at the bottom of the generated page, if that's possible.
> Maybe you can POST it? I might have a look tomorrow.
The one and only html validator:
Welcome to the W3C HTML Validation Service; a free service that checks
documents like HTML and XHTML for conformance to W3C Recommendations and
other standards.
http://validator.w3.org/
To link a page to the validator:
http://validator.w3.org/check?uri=http://to/your/web/page
To show your readers that you have taken the care to create an
interoperable Web page, you may display this icon on any page that
validates. Here is the HTML you could use to add this icon to your Web page:
<p>
<a href="http://validator.w3.org/check/referer"><img
src="http://www.w3.org/Icons/valid-xhtml10"
alt="Valid XHTML 1.0!" height="31" width="88" /></a>
</p>
Well it's possible... You could also post the page for offline pages, look
into the <form> in the page.
I use it frequently to make my pages conform to XHTML 1.0 strict.
cheers,
Daan Oosterveld
Notes
- Quoted lines have been omitted from some messages.
View the message alone to see the lines that have been omitted