Mailing-List: contact common-issues-help@hadoop.apache.org; run by ezmlm
Precedence: bulk
Reply-To: common-issues@hadoop.apache.org
Date: Mon, 8 Jul 2013 18:59:49 +0000 (UTC)
From: "Luke Lu (JIRA)" <jira@apache.org>
To: common-issues@hadoop.apache.org
Message-ID: <JIRA.12638879.1364220925519.12983.1373309989046@arcas>
In-Reply-To: <JIRA.12638879.1364220925519@arcas>
References: <JIRA.12638879.1364220925519@arcas>
Subject: [jira] [Commented] (HADOOP-9432) Add support for markdown .md files
 in site documentation
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit


    [ https://issues.apache.org/jira/browse/HADOOP-9432?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13702289#comment-13702289 ] 

Luke Lu commented on HADOOP-9432:
---------------------------------

doxia markdown module is based [pegdown|https://github.com/sirthias/pegdown] which supports table nicely.
                
> Add support for markdown .md files in site documentation
> --------------------------------------------------------
>
>                 Key: HADOOP-9432
>                 URL: https://issues.apache.org/jira/browse/HADOOP-9432
>             Project: Hadoop Common
>          Issue Type: New Feature
>          Components: build, documentation
>    Affects Versions: 3.0.0
>            Reporter: Steve Loughran
>            Priority: Minor
>         Attachments: HADOOP-9432.patch
>
>   Original Estimate: 0.5h
>  Remaining Estimate: 0.5h
>
> The "markdown" syntax for marking up text is something which the {{mvn site}} build can be set up to support alongside the existing APT formatted text.
> Markdown offers many advantages
>  # It's more widely understood.
>  # There's tooling support in various text editors (TextMate, an IDEA plugin and others)
>  # It can be directly rendered in github
>  # the {{.md}} files can be named {{.md.vm}} to trigger velocity preprocessing, at the expense of direct viewing in github
> feature #3 is good as it means that you can point people directly at a doc via a github mirror, and have it rendered. 
> I propose adding the options to Maven to enable content be written as {{.md}} and {{.md.vm}} files in the directory {{src/site/markdown}}. This does not require any changes to the existing {{.apt}} files, which can co-exist and cross-reference each other.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira