• Home
  • Script library
  • AltME Archive
  • Mailing list
  • Articles Index
  • Site search
 

World: r4wp

[Ann-Reply] Reply to Announce group

GrahamC
5-Jun-2013
[2117]
Henrik, correct me if I'm wrong but isn't markdown just a text formatting 
system as opposed to a document formatting system like make-doc ?
Henrik
5-Jun-2013
[2118]
Yes, but it seems to make sense to base body text on this and build 
the rest around it. MDP has a particular way to format body text, 
but we've found that it's hard to extend. I would like an MDP2 that 
much better is capable of outputting right down from a single paragraph 
of markdown to a full multi-page document.
GrahamC
5-Jun-2013
[2119x2]
well, to me it makes sense not to reinvent the world and just use 
an existing markup like asciidoc which is intended for documents
No one is going to convince the world to learn another markup language 
like mdp2
Henrik
5-Jun-2013
[2121]
Another point of MDP2 is to retain the single-script ease of use 
that MDP has, as well as being REBOL based.
GrahamC
5-Jun-2013
[2122]
I think that you can do that with asciidoc too .. using Chris' emitter 
and parser
Oldes
5-Jun-2013
[2123]
It would be really enough to have MDP accept MD's style of headings. 
It's just silly from the outside view to use extension .mdp instead 
of already supported .md. I know that mdp is better and more capable 
than md, but I don't think it's easy to change Github to use mdp. 
I'm quite lucky that my Rebol colorizer (even buggy a little bit) 
found it's way there, which was not straight at all.
Henrik
5-Jun-2013
[2124]
It would be really enough to have MDP accept MD's style of headings.
 - are you referring to MakeDoc or MarkDown? :-)
GrahamC
5-Jun-2013
[2125]
He's saying that using %.md for your existing %.mdp documents would 
be enough to use the existing markdown colouriser
Oldes
5-Jun-2013
[2126]
Unfortunately not enough to change extension. MDP is using === and 
--- for headers, where MarkDown is using ### http://daringfireball.net/projects/markdown/syntax
GrahamC
5-Jun-2013
[2127x2]
but at least it's better than nothing??
Although in the case of the broken R3 colouriser ... nothing is probably 
better :(
Gregg
6-Jun-2013
[2129]
As much as I love makedoc, and as many docs as I have in that format, 
a more widely adopted standard that is close in syntax and features 
seems like the best option as a standard.
GrahamC
6-Jun-2013
[2130]
I am advocating also that we be pragmatic rebolers
Pekr
6-Jun-2013
[2131x2]
ah, noticed Red's main git page uses some .md file. Thought that 
Github accepted our MD :-)
Is their md any less performant than mdp? As for me, +1 to accept 
some widely accepted format. Well, does anyone apart Git use .md?
AdrianS
6-Jun-2013
[2133]
Petr, it's used quite a bit these days. Just look around. I vote 
to go with a standard. Didn't we already have this discussion?
Arnold
6-Jun-2013
[2134x2]
yes lets go on using VHS, not betamax or v2000. It is a bit similar. 
If mdp2 can be more flexible than MD and you can show it is as easy 
as MD and even do more with it, who needs to convince the world? 
The whole world is far from using MD now. There is a whole lot of 
undiscovered country left.
And if you can have mdp process MD doc's with very little adaptation 
(adding a kind of marker at the beginning) you can easily take over 
MD.
Henrik
6-Jun-2013
[2136]
Arnold, yes, there are many competent document systems out there, 
but there hasn't been anyone that could be so easily plugged in and 
used as MakeDoc and MakeDocPro. I just want to move beyond their 
current limitations, so Saphirion can deliver professional, high-quality 
manuals to the customers.
Pekr
6-Jun-2013
[2137x2]
AdrianS: I am not against that. Still I have my question of the feature 
comparison of MD vs MDP unanswered ...
So basically - is MDP so much better, that we can't switch to MD 
instead?
Henrik
6-Jun-2013
[2139]
Pekr, I'll try to get a response from Robert, as he decides which 
way to go.
Ted
6-Jun-2013
[2140]
http://www.codinghorror.com/blog/2012/10/the-future-of-markdown.html
Arnold
6-Jun-2013
[2141]
I found MarkDown a good thought, like mdp, and ther obviously has 
been put some clever thinkwork into it, but six hashes for a h6 tag? 
And the alternative underline with "====" and or "----" does not 
convince me what happens if you do not match the length of the header? 
It compensates? so why not 3 or four like in mdp?
Pekr
6-Jun-2013
[2142]
if others might maky their stuff and claim it beind de-facto standard, 
we can as well ... not sure if markdown is more popular than what 
github is using for their .md, but we should either adhere, or make 
converters and go our own way, or even better - introduce some clever 
layer, which will allow to recognise their format and render it properly, 
while allowing .mdp to be more powerful
Arnold
6-Jun-2013
[2143]
what I said, in other words ;)
Maxim
6-Jun-2013
[2144]
my two cents.  

funny that all of these formats basically can be converted from one 
to the other in a few lines of parse.  


these text-based formats  may be super cool in non rebol scene, but 
I find this whole discussion about which equivalent to use... well 
... a bit anemic.


why not just use our own format internally and import from other 
formats at will... I mean really, its very easy to do.


I've been working with an extensible wiki format in QM and have been 
adding new things to it.  I don't see why we want to limit ourself 
to headers and titles and still wonder which one of the incapable 
formats to use.   are we using Rebol or are we trying to be as limited 
as all the others?  I mean, when I look at QM's wiki format I can 
add new specs in about 5 minutes, including supporting code which 
spits out html.  


 I think this kind of coding is something which must be leveraged 
 in any Open rebol project. let's allow people to import docs in whatever 
 format and manage them using something that makes sense for us?  
 including more expansive tags which are tailored for different sections 
 like a dictionnary, tutorials, traditional docs, guides, etc.
Arnold
6-Jun-2013
[2145]
now you're talking maxim! Presentation stuff ;)
Maxim
6-Jun-2013
[2146]
I've been rather dormant in many rebol spheres in the last months 
because I've been working a lot and most of it is commercial and 
private work, but I feel like its time for Rebolers to break out 
of their inferiority complex and show others that Rebol is better, 
more cutting edge than ever.  

And it still stays simple, overall, even in large projects.


I think the community has lost a bit of its resolve, and I am trying 
to make a point with the devcon.  Rebol has never gone away and its 
back on track.  


I think its up to everyone involved in public projects to promote 
this by actually playing on Its strengths.   I resisted the urge 
to build the site using public tools, and I think, Chris and I and 
building a super default framework just by catering to the needs 
of the devcon's web site.   Chris just added a news module to it 
(in one day).  we will show the site's internals at the devcon, showing 
how easy it really was to build up, using a centralized Git Repo 
to share the code and with the server, when ready for production.


Its ALL coded with REBOL.  at the devcon, we will look at packaging 
QM with cheyenne, Remark and making sure it all works with my web 
service API... with this l think the rebol community will have a 
pretty nice framework to rival RR and others.
Gregg
6-Jun-2013
[2147x2]
Thanks for posting that link Ted!


I, too, want an all-REBOL toolchain and format. However, I view MD/MDP 
as a very basic format for plain communication and HTML generation. 
It is not a "structured" document format.  And while extensible is 
good, we can probably come up with a spec that outlines all that 
might need to be handled, to help guide a baseline design. e.g., 
while it's XML, DocBook was well thought out IIRC.


I admit that one of my problems with makedoc, historically, is consistent 
behavior and support for images and links. 

Don't forget Gab's QML either.
I haven't used AsciiDoc, but it looks like it might be a nice standard 
to use, at a glance. I haven't looked at enough AsciiDoc source to 
say if I like the format though. It didn't grab me the first time 
I looked at it, but I'll look again. The header syntax puts me off 
a bit. http://powerman.name/doc/asciidocis a cheat sheet.
Andreas
6-Jun-2013
[2149x2]
Pekr, Markdown _is_ what Github is using for .md files.
Arnold, if you underline headers with === oder --- in headers that's 
sufficient. No need to match the header. I don't like the hash syntax 
either, but when I hear talk about h6: "remember that Feynman covered 
all of physics [..] with only two levels of document hierarchy".
GrahamC
6-Jun-2013
[2151x3]
@Gregg, asciidoc uses a header *because* it's a document formatting 
tool.  There's a variety of styles supported .. and it's a pain to 
try and remember but I guess it gets easier with use.  The point 
for me is that it provides entry to docbook and then multiple other 
formats whereas makedoc/pro are stuck in a single page style html 
which is really past it for any serious documentation.
Sure you can roll your own, but if we want other people to learn 
it, you're running up hill all the time.
Pekr, I have several markdown docs now in the document repository, 
and they display quite nicely on github
MikeL
7-Jun-2013
[2154]
For people in Windows Word World (I know I know ... double pane), 
MarkdownPad 2 was released on 05-Mar-2013 with standard and Pro version.

The pro version includes GFM support.  Pro costs $14.95 USD for a 
single user licence.
http://markdownpad.com/compare.html

This is the kind of stuff that I use because time isn't free and 
Git seems to be the place to converge to.
[If already posted (or hate windows), ignore immediately.]
GrahamC
7-Jun-2013
[2155x2]
Hmm.  I was asked to setup a brand new laptop with windows 8 today. 
 Cousin needs Office 360  so I click on the install which takes me 
to website.  I enroll him into windows live and start the installation. 
 Which then fails 5x .. brand new latop.  system restore and uninstall. 
 WTF!
I felt my BP rising steadily as I tried to negotiate Windows 8 using 
a mouse :(
Henrik
7-Jun-2013
[2157]
being a vegetarian doesn't help, when using Win8, I see.
Geomol
7-Jun-2013
[2158]
Maybe ASIMOVs Foundation is happening?
Maxim
7-Jun-2013
[2159]
at least you didn`t have to try using it with a touch pad.  *That* 
is frightening.  :-)
Arnold
7-Jun-2013
[2160]
Youtube channel: (RedREBOL was already taken anyone?) alternative 
could be theRedREBOL or theRedCoder or theREBOLCoder.
GrahamC
7-Jun-2013
[2161]
RedBol ?
Arnold
8-Jun-2013
[2162]
Reducation Channel?
GrahamC
8-Jun-2013
[2163]
Gulag ?
Arnold
10-Jun-2013
[2164]
@Arie, wrong group Announce. Bas already pointed this out. (Softwarefreedomday 
is his channel). I do not want to steal viewers from Bas' channel.

The point is I want to use this new channel as a dedicated channel 
for Red (and REBOL) specific video's. I imagine this being used by 
this community to post self-made tutorial video's on. The softwarefreedom 
channel is much broader than this. One does not exclude the other.
Gerard
11-Jun-2013
[2165x2]
Why not use separate channels for Red, Red/System and Rebol respectively 
or conversely using a family name like "Rebol-like languages" or 
"Rebolish" or something similar ? Personally I prefer using separate 
names, even splitting furthermore amongst Rebol2 and Rebol3 ... but 
this is a suggestion only. In the end I also see some specific place 
for Boron, World, and Topaz but then everyone should point to the 
others or to a single "entry point portail" which points and summarizes 
the évolution and differences while it could alos only point to each 
of the specific related websites, as they appear  !!!
May be "Rebol inspired languages"  would be enough ...