World: r4wp

I looked into the docs subdirectory, ran
rebol makedoc2.r 

It made red-system-quick-test.html, but then I got my eyes sore with 
the black background, so I wanted the light version, clicked and 
... oops:

Firefox ne peut trouver le fichier à l'adresse /home/pierre/heaume_pierre/developpt/Red/docs/$LIGHT$.

I found a reference to $LIGHT$ at the bottom of red-system-quick-test.txt 
, in what looks like a rebol script below a make-doc document.

REBOL []

do/args %makedoc2.r 'load-only
doc: scan-doc read file: system/options/script
set [title out] gen-html/options doc [(options)]

file: last split-path file
replace file ".txt" ".html"
file2: copy file
insert find file2 "." "-light"
replace out "$DARK$"  file
replace out "$LIGHT$" file2

write file out
replace out "dark.css" "light.css"
write file2 out

Makedoc format allows the addition of REBOL code at the end. The 
proper way to generate the doc files is to CD to the folder, then 
run REBOL on %red-system-quick-test.txt

ok

BTW, you can find these documentations already generated online here: 
http://www.red-lang.org/p/documentation.html

Isn't it a bit dark?...

It's to save power ... fewer photons emitted

What? The site or the docs?

;-) the site emits too few photons

to my taste...

Something that I miss, from this doc page, would be a "getting started" 
with a step-by-step guide to start coding in Red

Red on black is just nearly invisible.

Well, I try to switch to dark themes to both save powers and my eyes. 
;-) 


I've provided a switching option to more classical "light" theme 
for the docs, but doing the same for the web site was too much work 
for me, so I've left it with the dark theme only. I will fix that 
once we get a new web site for Red (or if someone skilled enough 
can make the changes, I'll be glad to push them online).

yes; and white on black with my firefox fonts is quite painful. I 
have a nuclear power plant nearby, providing enough electrons moving, 
so that I can afford to waste a few photons...

don't worry about this... just a detail

Graham: it renders well here, but I don't use Clear Type. I plan 
to make some typographic changes to the blog anyway to make it more 
easily readable, I'll see if I can improve the rendering of red text 
parts.

Actually, it is better on an LCD display, than on my old CRT.

I've trashed my last CRT in 1997. ;-)

Actually, if some people want to tweak the CSS for the Red blog to 
make it more readable, I'll be glad to review and push the changes 
if I'm fine with them.

Can you add a link to the makedoc files on each html page?

There is no makedoc files, I'm using the Blogger platform (Google). 
Unfortunately, a bad choice, it is an awful blogging platform, the 
only part that doesn't suck is the Google Analytics integration.

You can just use Firebug or the developer mode from your browser 
to retrieve the CSS files.

Oh ...

I've tried playing with the background in the CSS, but it is not 
really convincing... I got a dark red, which looks more like vomi 
d'ivrogne...

Off-topic warning: I know most of you know this, but for any noobs 
that come along:  With LCDs and LEDs, the number of photons remains 
constant no matter the color scheme as the LCD/LED layers just filter 
out the light that is already generated by the backlight.  Some advanced 
screens will dim the backlight to the intensity of the brightest 
pixel, but these screens aren't as common.

vomi d'ivrogne
 Isn't that shade of red color better known as "Bordeau". ;-)

yes, sort of...

you are more poetic than I am...

Regarding docs, the issue for me, and perhaps others, is that reading 
html on your portable device requires an internet connection. So, 
an offline version such as epub or pdf is an advantage

Bo: ah thanks...then it is just for the eyes. ;-)

I do a lot of reading on an itouch ( should upgrade to something 
bigger )

GrahamC: yes, I totally agree. I am quite often out of Internet connexion 
for long periods, so I do appreciate long html pages that I can save, 
rather than bunches of small html pages. A large pdf is even better. 
Or a large .txt file, actually.

Well, all the existing Red docs are on github, so feel free to add 
PDF generation, I will gladly add them to the web site.

I'm not sure the Makedoc version I'm using supports PDF export though...it 
might need an upgrade to MD3.

all the existing Red docs are on github
 => is that what is in Red/docs ?

Is there a MD3 that is OS?

 is that what is in Red/docs ?

 Yes...except the "Red/System BNF grammar" doc that is produced directly 
 in PDF format by Rudolf.

MD3: I don't remember...but I sort of remember a MD version with 
PDF export...

Yes, we've been discussing this in R3 docs  There isn't one that 
is publically available.

Hasn't Gabriele done a MD-to-PDF converter by any chance?

Gabriele's md3 was his literate documentation

I have a rather tortuous path using makedoc => asciidoc => pdf/epub

Yes, Gabriele has a PDF generator. Don't remember if it supports 
MakeDoc format

Can't someone from the community make a MD to Gab's PDF dialect converter?

Such tool would be useful both to Red and R3 projects.

Gab's PDF emitter is pretty old now.  Doesn't support active links

That, and I believe you'd still need to manage much of the typesetting.

And AFAIR, it doesn't support external images

It'd be a significant undertaking.