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

World: r3wp

[Make-doc] moving forward

Christophe
1-Nov-2005
[629]
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
[674x3]
Hi,
Hi,
Is there any easy way to get blank columns in makedoc tables?
[unknown: 9]
12-Jan-2006
[677]
\table

<BR>


=row

<BR>


/table
btiffin
12-Jan-2006
[678]
Thanks Reichart, I was just about to post that I stumbeld on a non 
breaking space  &nbsp; solution.