World: r3wp

and allow insertion of automatically scaled images

This is an odd one. I just re-downloaded makedoc2.r and for whatever 
reason I can get it to output. The html file includes only <% page-body 
%> despite the in input including the examples. ANyone have any ideas?

james;  My quick test worked out ok.  Do you have a local template.html 
maybe?  Which version did you snag.  I just pulled one out of rebol.org 
with Version: 2.5.7  Date: 10-Mar-2007  And then saved the MakeDoc 
Example from http://www.rebol.net/docs/makedoc/fastmd.htmland it 
worked as expected.

Btiffin, let me check...

I have the same makedoc version 2.5.7 and view 1.3.2.3.1. I've tried 
that exact example as well though with verbose on I am seeing an 
error:

** Script Error: copy expected range argument of type: number series 
port pair
** Where: debug
** Near: copy/part here find here newline

Without verbose on I don't get the error but then I don't get the 
output either. I'll check to see if it thinks I need a template. 
Shouldn't of course.

Hmmm, sounding weird.

I know.

Thanks, btiffin, I changed the template-file to false. Now I'm goning 
to check if that is in the script.

I can't even find  page-body  anywhere in the source code.  And the 
<%  %> makes me curious too. It might be something on the server 
side.

Well, at least my mind wasn't playing tricks on me. The version in 
the script library has the template set to a file. Thanks for the 
hint!

%template.html  is a "one-of" default.  If it is not found it uses 
the embeded copy.  This code here
	if not no-template [

  template: any [select opts 'template select doc 'template template-file]
		if file? template [template: attempt [read template]]
		if not template [template: trim/auto default-template]
	]
It's actually pretty handy.

I'm starting to think you have more of a server side issue somewhere. 
 Something is tripping that <% page-body %> to get sent as the 'page' 
instead of the actual expanded page-body.

Could be but since it works I can get back to creating. I think you're 
right in that there is more than meets the eye.

Where can I find the latest make-doc.txt file used the make the Make-doc.html 
page at http://www.rebol.org/cgi-bin/cgiwrap/rebol/documentation.r?script=makedoc2.r

My house  :)  Unless you mean the actual useful example page at http://www.rebol.net/docs/makedoc/fastmd.html
in which case I don't know.  The doc I did for the library is mostly 
just a pointer guide to other guides.


When looking at the the docs in rebol.org you should see a Download 
Documentation As: HTML or editable.  The editable version is very 
close to the orignal source text  to get a clone of the original, 
just cut out the 5 or 6 lines of download header.  The first line 
of the original is

Introducing %makedoc2...

Thanks Brian,  Yep the editable version worked just fine!!!

That'll work for some docs, but a lot of rebol.org documentation 
is in Mulch.  The mulch processor isn't released for offline use 
yet.

You know, its kind of funny.  When I saved the document on my computer 
and opened it via wordpad, it opened up just fine.  When I renamed 
it from .r to .txt and then reopened it, wordpad had a lot of funny 
characters in it.  I had to rename it back to .r  reopen the document 
using wordpad and then did a save as .txt.  Now it looks just fine. 
 Must be a unicode thing or something like that!

Yeah, it's amazing that good old text format is now starting to break 
down as we head toward different encodings.  System designers like 
to outsmart themselves sometimes.  :)  Not that advancing out of 
an English only ASCII character set is a bad thing, but it may take 
a while to get everything back to quick and easy again.

What is the status about writing great docs? mac-doc? what is latest 
version? or QML or other? thank you!

My opinion; makedoc2.r is the preferred RT markup engine.  I like 
to promote Gabriele's PDF-Maker as well.  For DocBase, you need to 
get used to wikitext.  Take a look at http://www.rebol.org/cgi-bin/cgiwrap/rebol/documentation.r?script=makedoc2.r
for a fairly complete view of the various tools at our disposal. 
 Some are awesome domain enhancing tools such as John's nicomdoc 
with the math extensions.

I just found some broken links in my NicomDoc 2 spec at http://home.tiscali.dk/john.niclasen/nicomdoc/NicomDoc.html
Those should be fixed now.

I've been using NicomDoc with math for almost a year and a half now 
at university. It must be one of the fastest way there is to write 
equations. Many examples of use can be seen in my notes at: http://www.fys.ku.dk/~niclasen/

What is the status of MD? which one would you suggest or are you 
using the most? md, mdp, md3, nicomDoc ?

I guess, I shouldn't answer this. ;-)

I use makedoc2 right out of rebol.org and one I call makecv, that 
strips out all the ardornment from the default template.  Orginally 
modified for a resume, comes in handy for a few things.  nicomDoc 
for that rare times I need math.  But to be honest, Mulch, the markup 
used in a lot of the rebol.org documentation is pretty nice; but 
to use it you need to document rebol.org <wink><wink>  Sadly, I'm 
now getting too used to wikitext from DocBase.

Thanks, I'll go with md2 from rebol.org then

wooo.. my bad I just see I asked the same question in January.. sorry 
;) maybe I need holidays..

I'm having a problem with tables n Makedoc2: 
\table header
Extension_Ladders | Closed_Length | Weight |||
35'  | 20' | 135 lbs.
25'  | 15'  | 100 lbs.
24'  | 14' | 80 lbs.
16'  | 10' | 70 lbs.
/table

I'm getting a table that is six cells across and two rows down (Header 
and 1 row). - Not what I'm  looking for.

\table header
Extension_Ladders | Closed_Length | Weight ||
35'  | 20' | 135 lbs. ||
25'  | 15'  | 100 lbs. ||
24'  | 14' | 80 lbs. ||
16'  | 10' | 70 lbs. ||
/table
Getting closer: Now I have two cells and 6 rows.

Is this make-doc2? Look a bit like MDP... ;-) If it's MDP remove 
the last || before the /table line. Because otherwise it means: Ok, 
add an other row. But there is not content coming.

THanks

NicomDoc has been moved to: http://www.fys.ku.dk/~niclasen/nicomdoc/

(NicomDoc is a document format based on MakeDoc2 with math formulas 
and some other stuff.)

I'm using md2 v2.5.7 and cannot get the template function to work 
correctly. Is anyone having the same issue? In the file i use =template 
template_name

hmm... I never used it, so I can't tell whether it works or not.

could you describe the problem more closely?

Henrik, when i have =template template_html_file as an example in 
the txt file and run md the parser just ignores it and uses the builtin 
template and does not use the seperate templating file

according to the make-doc code, it reads the file using:

if file? template [template: attempt [read template]]


so if it's not being read, it's being ignored, so perhaps check if 
the file can be read in the same console as make-doc uses.

do we have a make-doc with a PDF emitter? I would like to use make-doc 
with a cgi script to create registration forms and PDF them before 
mailing

I have basic PDF emitter for my make-doc-pro.

Robert, is your PDF emitter something i can use? How could i try 
it out :)

Well, I didn't touched it for a long time. So it's very basic (should 
have noted this more clear). I can send you all the parts and you 
can take a look.

Let me know.

There is a simple question I need your help with regarding MakeDoc. 
Please see:
http://www.rebol.com/article/0446.html