r3wp [groups: 83 posts: 189283]
  • Home
  • Script library
  • AltME Archive
  • Mailing list
  • Articles Index
  • Site search
 

World: r3wp

[Make-doc] moving forward

Geomol
1-Nov-2005
[626x2]
And don't let the XML part acare you away, it's NOT XML, as you know 
it, just the good thoughts from XML. RebXML is based on blocks, words 
and strings.
acare = scare
Christophe
1-Nov-2005
[628x2]
I'm sure your format has a lot of possibilities. FYI, there's a little 
compare study  published on http://rebolfrance.info/articles/gendoc_avec_rebol
. But a few years ago, I had to make a choice on the format to use, 
and it became MDP (MD2 then when it was released).
I find the idea of using simple tags to generate doc a improvement 
for professionals. Every time I have to use the m$ word, I'm stuck 
into format problems and i spend more time find a solution to it 
than concentrating on the core of my text. But i guess this is a 
known complaint :-)
Robert
1-Nov-2005
[630x3]
Printing: With the COM stuff now, I'm going to do a MS Word emitter 
for MDP. Than this shouldn't be a problem.
XML: Well, I choose to use a block based intermediate format coming 
from the MDP parser. It's because you can handle it the Rebol style 
and it makes writing a one-pass emitter quite easy.
standardization: Yep, I agree. But seems like we have to many options, 
different thinkings and preferences, to many forks etc. I tried it 
several times but no luck. I think it won't happen, and I don't spend 
any more time on this standardization stuff. It needs people to push 
it and without a group wanting this it won't happen.
Christophe
1-Nov-2005
[633x2]
Too bad :(
But keeping standardization on the side, are they any ideas of working 
on compatibility ? I mean: doc developped under MDP should be readable 
under MD2, for example. Or is the workgroup totally dead ? (in which 
case it should be announce on rebol.net... i think).
Pekr
1-Nov-2005
[635x3]
workgroup has not set any timeframes etc.
dead or no, it depends upon ppl's needs - if noone needs such standardisation, 
it will not happen ...
imo we need new rebol blood and we should try (I am trying :-) to 
recruit new blood to join us :-) every developer can help ...
Christophe
1-Nov-2005
[638]
u mean for this WG ?
Pekr
1-Nov-2005
[639]
not only ...
Christophe
1-Nov-2005
[640]
About new blood... this is a conversation which appears regularly 
within the french rebol community; How make rebol more popular ... 
but this is becoming off-topic, perhaps we should move to... well, 
to where ? :-)
Pekr
1-Nov-2005
[641]
French community is "strange" - it is very cool and active, yet it 
creates barrier for rebol adoption a bit - many of good materials 
are not in english. We help short talk about it with Cyphre - if 
rebol.cz should be czech only, or something like rebolforces, so 
in english ... (or both :-)
Robert
1-Nov-2005
[642]
compatibility: MDP should be 100% MD compatible. I'm not sure about 
MD2 but if you find any differences let me know.
Christophe
1-Nov-2005
[643x7]
Yes, Pekr. u're right ! Its called language barrier :-)
No. No joking now... For lot of french taking ppl, another language 
than french is on the border of the unbiliefable. But isn't so also 
for the native english talking ppl ?
We started in february this year with the "REBOL Documentation Project" 
initiative with also this goal into our vision: let's make REBOL 
popular by translating doc ! There's a LOT of high value articles 
and studies abour REBOL out there... lonely in english ... (Ladislav 
:-) ) or in french ... let's translate it ! let's publish it !
For now, we succeed a bit into getting good french documentation. 
But it can be still beter ! OK, i can admit, i did not deploy a lot 
of effort to "recruit' english-speeking author for publishing on 
our website ... Yet, it stays open ! Come on in ! Do YOU have something 
to say about REBOl ? Do you want to make it publicly accessible ? 
We need YOU ! Contact me and get on the 'REBOL Documentation Project' 
!
OK... Should we create a new "REBOL Documentation Project" aka "REBDocProj" 
group ?
I should note i'm Belgian, not French :-))
Robert: well, i didn't go into your latest version, but is the table 
handling not a compatibility problem? i mean =row against || text 
| text ...
Robert
2-Nov-2005
[650x3]
Tables: Yes, I didn't yet implemented it. But shouldn't be that hard 
to do.
I thought, for several times, to rewrite the MDP parser to use Garbriele's 
compile-rules function. Should make the parser simpler and more compact. 
Further I could design it in a way to handle the different approaches 
better.
But this needs quite a lot of time...
MikeL
9-Nov-2005
[653]
I don't find URL support as described in http://www.rebol.net/docs/makedoc/md1.html#section-5.5
 in the released makeDoc version accessible at http://www.rebol.org/cgi-bin/cgiwrap/rebol/view-script.r?script=makedoc2.r
   Rambo 488 raised for this.
Graham
9-Nov-2005
[654]
that url directive only works if it's on the left margin.
MikeL
9-Nov-2005
[655]
Hi Graham,  this version ignores my =url request and look at the 
source http://www.rebol.org/cgi-bin/cgiwrap/rebol/view-script.r?script=makedoc2.r
  I can't find any URL text string in that source.

I think this version does not support =url at any column position.
Louis
10-Nov-2005
[656]
The web page created by makedoc2.r is too wide for my screen. How 
can I make the lines wrap at the right border of the window so that 
when the window size is changed the line breaks are automatically 
adjusted?
Robert
10-Nov-2005
[657]
IIRC it's some CSS style/tag named "float"... but not sure, out of 
my head.
Alek_K
10-Nov-2005
[658]
Louis:  simplest solution - change width of table (can be percents) 
- or delete it 

<table width="660" cellpadding="4" cellspacing="0" border="0"> to 
<table cellpadding="4" cellspacing="0" border="0">
Louis
10-Nov-2005
[659]
Robert and Alek_K, thanks for responding. Deleting the table altogether 
solved the problem. Thanks!
MikeL
16-Nov-2005
[660]
For makedoc2.r input log 488 on Rambo which has morphed to Reviewed 
log 3955, this change deck provides =url support for anyone who wants 
it.  

The line changes are all inserts and the line number is the download 
version from the script library as of a few minutes ago

-ins 136

        | "url" url

-ins 169 


url: [
    some space copy text thru newline (
        emit url parse/all text " "
    )
]


-ins 311 

            url         [emit-url doc/2]


-ins 512

emit-url: func [spec] [
    emit [reduce {<a href="} spec/1 {">} skip spec 1 </a><p>]
]
Josh
6-Dec-2005
[661]
I'm running into that issue.  Is there another way to do URLs in 
MakeDoc2 besides the supposed =url ?
Volker
6-Dec-2005
[662x2]
Plain html?
Or patching :)
Josh
6-Dec-2005
[664]
We'll see if I have any luck trying to patch it, volker
Volker
6-Dec-2005
[665]
Where is the source, what do you need? IIRC i patched it once, so 
i may remember where to place code.
Josh
6-Dec-2005
[666x3]
It looks like MikeL has it above this.  I'll just make those changes 
and confirm it
OK, I updated the MakeDoc2 file per MikeL's changes and here is a 
URL for testing:   http://www.cs.grin.edu/~shirema1/makedoc2.r
Worked ok for me
Volker
6-Dec-2005
[669]
Quick work :)
Josh
6-Dec-2005
[670x2]
Thank you
MikeL
james_nak
12-Dec-2005
[672]
Is there a way to make blank lines (also blank boxes) in Makedoc?
Volker
12-Dec-2005
[673]
if nothing else: html. <br> <p>
btiffin
12-Jan-2006
[674x2]
Hi,
Hi,