World: r3wp

With MakeDoc2 is there any way to comment out a block of text you 
don't want to print? I found =: but that doesn't seem to work. Or 
perhaps I just don't know how to use it.

put ; in front of the paragraph

henrik, the source to that page uses \column ... =column ... /column

Gabriele, Thanks! I should have known to try the REBO way. But the 
comment in MakeDoc2 says to use "=: "

REBO = REBOL

; Options still need work!!!
 <---- found this in the source code for makedoc 2 on rebol.org


Does this mean that reusing makedoc in the same run-time session 
really is broken? If I turn off table of contents for one doc, it 
will not be on for the next for example.

I found a bug that accumulates the options over several documents. 
maybe I can fix it...

Fixed!

set 'scan-doc func [str /options block] [
    clear out
    title: none

    if options [
        if find block 'no-title [title: true]
    ]
    emit options opts
    clear opts
    str: join str "^/^/###" ; makes the parse easier
    parse/all detab str rules
    if verbose [
        n: 1
        foreach [word data] out [
            print [word data]
            if (n: n + 1) > 5 [break]
        ]
    ]
    out
]

options are now cleared properly before a makedoc document is scanned.

To Brian's comments on Make-doc.  I've tried using it as well.  I 
found it was great for short documents and started to get hard to 
us as we moved to larger documents.  i shouldn't say hard to use, 
but hard to edit the document once I made changes or stumbled across 
errors in the original.  I should have used 'find' more, as it really 
was difficult to scroll around and find where you were in a larger 
documents.  Has anyone else experienced the same thing?

Yes, I have some problems navigating my large documents in NicomDoc 
format, which is original based on MakeDoc. I use search/find a lot. 
Maybe a syntax recognizer using colours would help.

I was thinking a conscious effort in adding lots of additional blank 
space in the document would help better define paragraphs and sections 
of the document.  So it's ignored by the MakeDoc parser, but gives 
the user a better visual hint, which is what the difference is between 
the text and the output.

Perhaps a syntax highlighter for kate or other folding editor would 
help?  Not that I know

anything about syntax files for editors...I haven't run PC edits 
in a long while, but most
editors now support code folding.  At least in Linux land.

May be the answer.  Might have to look into this the next time I 
play with Make-Doc

I would like to see a rewrite that lets it work on a series of text 
documents, build a TOC an link to subdocuments, like the HTML REBOL/Core 
manual.

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