Hello World Example for the MarkdownTaglet.

HelloTaglet.java

package mdtaglets;

import ch.raffael.doclets.pegdown.mdtaglet.MarkdownTaglet;
import ch.raffael.doclets.pegdown.mdtaglet.MarkdownTagletBase;
import org.apache.commons.lang3.StringUtils;

import java.util.List;

/**
 * # HelloTaglet is a sample {@link MarkdownTaglet}.
 *
 * It's say Hello in English (language='EN') or Ciao in Italian (language='IT') to the people in the argument list.
 */
@SuppressWarnings("unused")
public final class HelloTaglet extends MarkdownTagletBase {

    private String language="EN";

    public HelloTaglet() {
    }

    private HelloTaglet(String language) {
        this.language = language;
    }

    @Override
    public String getName() {
        return "hello";
    }


    @Override
    public MarkdownTaglet createNewInstance() {
        return new HelloTaglet(this.language);
    }

    /**
     * Set the (default) language with -mdt-hello-lang IT. 
     */ 
    @Option("hello-lang")
    public void setDefaultLanguage(String language) {
        this.language = language;
    }


    @Override
    public String render(List<String> argumentList) throws Exception {
        return "_" + sayHelloTo(argumentList) + "_";
    }

    private String sayHelloTo(List<String> argumentList) {
        final String audience = " " + StringUtils.join(argumentList, ", ");
        switch(language) {
            case "IT":  return "Ciao" + audience;
        }
        return "Hello" + audience;
    }
}