World: r3wp
[Make-doc] moving forward
older newer | first last |
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 solution. |
older newer | first last |