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

World: r3wp

[Make-doc] moving forward

Geomol
18-Jan-2005
[256x2]
LOL! I keep typing "specifikation", it's of course "specification".
specifikation
 is danish
Robert
18-Jan-2005
[258]
paragraph level: Hmm... I don't like it much. Not simple-user compatible. 
Any why provide two ways of saying one thing? I know Rebol has it 
too but this doesn't make things simple.
Geomol
18-Jan-2005
[259x2]
Yes, that's a concern. hm
It's difficult to judge finally, before I have a working formatter. 
Some things look good in theory, but fail in practical use. One thing 
is for sure, writers should be able to write anything, any combination 
of characters, and get the wanted output in an easy way.
Robert
18-Jan-2005
[261x2]
Take LaTeX than.
make-doc and make-doc-pro is for simple to medium complex documents. 
Not more. I don't think MDP is a replacement for a word-processor, 
DTP program or something near like LaTeX.
Geomol
18-Jan-2005
[263]
Good points!
Henrik
18-Jan-2005
[264]
I have to agree... I use MDP for three reasons: It's speedy, it's 
fast and it's not slow. :-)
Robert
18-Jan-2005
[265]
These are two :-))
Pekr
18-Jan-2005
[266x2]
:-))
...but maybe he meant speedy in how you can prototype your docs and 
not slow as not slowly generating result :-)
Gregg
18-Jan-2005
[268]
Yes, tools like MakeDoc are about focusing on content, not style. 
It's great if we have a *way* to do more complex things (extension, 
manual tag insertion, etc.), but they shouldn't be a priority.
Ashley
20-Jan-2005
[269]
Looking at MakeDoc2 a bit closer I note that TOC expansion occurs 
during the second parse (HTML emit), meaning that  a 'scan-doc will 
not return all the data required by other emitters. I don't believe 
it should work this way.
Robert
20-Jan-2005
[270]
The first pass generates a block structure that can be scanned by 
every emitter to get all headings etc. So, after scan-doc the info 
is there but not the build-up TOC.
Ashley
20-Jan-2005
[271]
Exactly, which means each emitter then has to generate a TOC and 
number the section headings - this content manipulation should not 
be the concern of each and every emitter! ;)
Chris
20-Jan-2005
[272]
It'll still have to occur after the first pass, natch -- 'tis a pass 
unto itself.
Robert
21-Jan-2005
[273x2]
The thing is, that the TOC might look very different depening of 
the output format. A TOC for LaTeX is just one command, for HTML 
you need to insert numbering as plain text etc.
Some emitters want numbers others letters or mixes of both. It all 
depends and that's why the job is left to the emitter.
Sunanda
21-Jan-2005
[275]
Good points,. Robert. And some may need to defer it until nearly 
the end of Phase 2 because they need actual page numbers.
Ashley
21-Jan-2005
[276x2]
OK, makes sense now. ;)
How about this for an obvious enhancement: the ability to href an 
=image (i.e. image + URL)
eFishAnt
21-Jan-2005
[278]
good idea, Ashley...the Devcon page maker has this in it, if I understand 
what you mean.
Robert
21-Jan-2005
[279x3]
Can you give me an example?
You want to use =image with an URL? That's possible.
update: I just extended make-doc-pro to support forms. Looks like 
this:

Test of Form Dialect in make-doc-pro

=toc

=options debug

===Introduction
This file test the form generation dialect.

\form test.cgi
	cgi-bin http://localhost/cgi-bin/

	; same-width with fields & buttons
	same-width left [
		field "Name1"
		field "Name12" 10
		field "Name123" 10 20
		field "Name"
		radio "R1" [Robby Linna Bunny Blacky]

		btn-enter "Abschicken"
		btn-cancel "Abbrechen"
	]

/form
Ashley
21-Jan-2005
[282]
You want to use =image with an URL? That's possible.

For example:

	=image %myimage.png http://mysite.com


click on the image to go to the site. I don't think the MD2 standard 
currently supports this.
eFishAnt
21-Jan-2005
[283x2]
I did wonder if that was what you meant...a good suggestion.
(and not hard to do at that)
Robert
21-Jan-2005
[285x2]
I would suggest something else:
=url http://www.mysite.com%image.png
It's a URL you want to specify, not the image.
Chris
21-Jan-2005
[287x4]
I never like to do to many arguments in Make-Doc, but what of Alt 
Text...
=url http://www.mysite.com%image.png Alt Text, but code sensitive 
parts of the line are getting more numerous...
Re. Forms, as discussed briefly, I have a different vision for forms 
-- primarily as I think we have a different end user in mind.
Perhaps this is better discussed in a dedicated group...
Ashley
27-Jan-2005
[291]
A proof of concept IDE for MakeDoc2 - http://www.dobeash.com/files/md2-ide.zip
- enjoy! ;)
DideC
27-Jan-2005
[292]
Argh! You was faster than me !! 

I wanted to do a things like that. I have a style to render inline 
formating if you want.

I have also an editor with some funcs to help inserting tagswith 
key shortcut.

Do you bother if I do a fork of it with my own idea ?
Ashley
27-Jan-2005
[293]
I have a style to render inline formating if you want
 ... yes please!

Do you bother if I do a fork of it with my own idea?
 Not at all, the code is really QAD though ;)
Geomol
27-Jan-2005
[294]
Cool! :-) I'm looking forward to something like this for my NicomDoc 
format, when I release it soon. ;-)
eFishAnt
27-Jan-2005
[295x2]
nice, Ashley
curious about QAD ?
Gregg
27-Jan-2005
[297]
Isn't there also an MDP-GUI project somewhere?
DideC
27-Jan-2005
[298x2]
MDP-GUI is on rebol.org.
But it's not what I need. MDP-GUI is a help for those who don't know 
MakeDoc rules.

I just want an editor that help me to insert the most bothering tags 
(like <b></b>) arround the text I want.

Typing tags is not very confortable on French Keyboard : < and > 
are on the same key and the last require Shift. / require Shift too. 
So typing tags all the time is very annoying.
Volker
27-Jan-2005
[300]
How about own tags and a preprocessor?
DideC
27-Jan-2005
[301]
explain.
Volker
27-Jan-2005
[302]
mark tags in a different way. maybe {tag} or [tag]. then exchange 
"{" with "<". then makedoc.
eFishAnt
27-Jan-2005
[303x2]
good point on  < > DideC
that is why [ ] is used in REBOL instead of { } for blocks, so a 
shift key is not needed, IIRC.
Geomol
27-Jan-2005
[305]
[ and ] is <Alt Gr>-8 and 9 on my danish keyboard. Where are they 
on a french keyboard?