World: r4wp
[Ann-Reply] Reply to Announce group
older newer | first last |
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 ... | |
Gregg 11-Jun-2013 [2167] | We do have #notREBOL for general chat on REBOL alternatives. |
Gerard 12-Jun-2013 [2168] | @Gregg : I was thinking the group was in search for a new name on Youtube, not here, isn't it ? |
older newer | first last |