Comments on: Humane Text Formats http://bluebones.net/2005/02/humane-text-formats/ Adventures in Computer Programming Wed, 20 Aug 2008 07:01:40 +0000 http://wordpress.org/?v=2.5.1 By: Is HTML a Humane Markup Language? | The CyberwBlog http://bluebones.net/2005/02/humane-text-formats/#comment-22938 Is HTML a Humane Markup Language? | The CyberwBlog Wed, 04 Jun 2008 19:29:01 +0000 /?p=94#comment-22938 [...] Let’s consider a simpler example. What we’re looking for is some kind of middle ground, a humane text format. Let’s start with some basic HTML. [...] [...] Let’s consider a simpler example. What we’re looking for is some kind of middle ground, a humane text format. Let’s start with some basic HTML. [...]

]]> By: Is HTML a Humane Markup Language? - Programming http://bluebones.net/2005/02/humane-text-formats/#comment-22909 Is HTML a Humane Markup Language? - Programming Wed, 04 Jun 2008 03:07:29 +0000 /?p=94#comment-22909 [...] Let's consider a simpler example. What we're looking for is some kind of middle ground, a humane text format. Let's start with some basic HTML. [...] [...] Let's consider a simpler example. What we're looking for is some kind of middle ground, a humane text format. Let's start with some basic HTML. [...]

]]> By: Sweetraskels Blog» Blog Archive » Is HTML a Humane Markup Language? http://bluebones.net/2005/02/humane-text-formats/#comment-22713 Sweetraskels Blog» Blog Archive » Is HTML a Humane Markup Language? Sat, 31 May 2008 09:33:51 +0000 /?p=94#comment-22713 [...] Let’s consider a simpler example. What we’re looking for is some kind of middle ground, a humane text format. Let’s start with some basic HTML. [...] [...] Let’s consider a simpler example. What we’re looking for is some kind of middle ground, a humane text format. Let’s start with some basic HTML. [...]

]]> By: Tim http://bluebones.net/2005/02/humane-text-formats/#comment-15410 Tim Sat, 29 Dec 2007 04:44:23 +0000 /?p=94#comment-15410 I went through a similar exercise, although I focused on Textile and Markdown because they are directly supported by Django which I use for web development. I am using Textile and it works well in general. Markdown has an advantage that is specifically relevant to my application: if you want to allow other users to enter marked up text (e.g. article submissions) to your site, you want to be able to escape html so they can't do screwy things with your page layout. Textile uses quotes in URL syntax, which is one of the characters you need to escape to completely protect against embedded HTML errors. I believe that Markdown text can be completely escaped prior to processing into HTML, which effectively enforces Markdown-only markups. For this reason I am considering changing from Textile to Markdown. tim I went through a similar exercise, although I focused on Textile and Markdown because they are directly supported by Django which I use for web development. I am using Textile and it works well in general.

Markdown has an advantage that is specifically relevant to my application: if you want to allow other users to enter marked up text (e.g. article submissions) to your site, you want to be able to escape html so they can’t do screwy things with your page layout. Textile uses quotes in URL syntax, which is one of the characters you need to escape to completely protect against embedded HTML errors. I believe that Markdown text can be completely escaped prior to processing into HTML, which effectively enforces Markdown-only markups.

For this reason I am considering changing from Textile to Markdown.

tim

]]> By: Michael http://bluebones.net/2005/02/humane-text-formats/#comment-2505 Michael Thu, 19 Oct 2006 20:34:24 +0000 /?p=94#comment-2505 I think readability of code is an issue, and thats why any HTML helper tool won't be sufficient for a lot of us. I get sick of everything being XML this and XML that, thankfully YAML/JSON seem to be getting used in some projects instead and hopefully the same goes for markup's like those mentioned here. Embedded HTML was critical, which some text2html languages didn't have (but should have) Personally, my use of tables leans me to Textile, but I will try Markdown and see how it goes also. Great article! I think readability of code is an issue, and thats why any HTML helper tool won’t be sufficient for a lot of us.
I get sick of everything being XML this and XML that, thankfully YAML/JSON seem to be getting used in some projects instead and hopefully the same goes for markup’s like those mentioned here.

Embedded HTML was critical, which some text2html languages didn’t have (but should have)
Personally, my use of tables leans me to Textile, but I will try Markdown and see how it goes also.

Great article!

]]> By: xah lee http://bluebones.net/2005/02/humane-text-formats/#comment-2379 xah lee Mon, 09 Oct 2006 03:11:27 +0000 /?p=94#comment-2379 Or, you could and probably should, use a HTML helping editor, such as Emacs. When such a editor is well done, it takes away the pain of writing the markup. It is, after all, the sole intended purpose of such editors. I introduce: Emacs and HTML http://xahlee.org/emacs/emacs_html.html Xah xah@xahlee.org ∑ http://xahlee.org/ Or, you could and probably should, use a HTML helping editor, such as Emacs. When such a editor is well done, it takes away the pain of writing the markup. It is, after all, the sole intended purpose of such editors.

I introduce: Emacs and HTML
http://xahlee.org/emacs/emacs_html.html

Xah
xah@xahlee.org
∑ http://xahlee.org/

]]> By: Jakub Narebski http://bluebones.net/2005/02/humane-text-formats/#comment-1153 Jakub Narebski Thu, 18 May 2006 13:09:20 +0000 /?p=94#comment-1153 What about AsciiDoc (http://www.methods.co.nz/asciidoc/), how it compares to mentioned formats? I know it has output/conversion to PDF, XHTML, HTML Help, manpage or plain text. What about AsciiDoc (http://www.methods.co.nz/asciidoc/), how it compares to mentioned formats? I know it has output/conversion to PDF, XHTML, HTML Help, manpage or plain text.

]]> By: Thomas David Baker http://bluebones.net/2005/02/humane-text-formats/#comment-321 Thomas David Baker Wed, 03 Aug 2005 08:17:56 +0000 /?p=94#comment-321 Thanks for letting me know. I've corrected the table above. Thanks for letting me know. I’ve corrected the table above.

]]> By: Marcelo Huerta http://bluebones.net/2005/02/humane-text-formats/#comment-320 Marcelo Huerta Wed, 03 Aug 2005 03:53:20 +0000 /?p=94#comment-320 You are wrong on two counts about reStructuredText. 1. The class atribute is supported, with the class:: directive (for paragraphs) and the definition of roles (for spans). 2. There are 'id' definitions... but they are autogenerated. You are wrong on two counts about reStructuredText.

1. The class atribute is supported, with the class:: directive (for paragraphs) and the definition of roles (for spans).

2. There are ‘id’ definitions… but they are autogenerated.

]]> By: Thomas David Baker http://bluebones.net/2005/02/humane-text-formats/#comment-248 Thomas David Baker Tue, 15 Mar 2005 17:20:29 +0000 /?p=94#comment-248 Well, I've written a couple of posts here and a good few other text files recently and apart from underlying the section headings with equals and then dashes for the subsections my foray into humane text formats has left me in pretty much the same positionas I was before I started: plain text becomes pseudo XHTML at the first sign of a link and then at the end I go through and clean it all up to valid XHTML. So I seem to have followed your path too. Well, I’ve written a couple of posts here and a good few other text files recently and apart from underlying the section headings with equals and then dashes for the subsections my foray into humane text formats has left me in pretty much the same positionas I was before I started: plain text becomes pseudo XHTML at the first sign of a link and then at the end I go through and clean it all up to valid XHTML. So I seem to have followed your path too.

]]>