Есть ли примеры Java, использующие Mylyn WikiText?

Я хочу использовать Java для кодирования преобразования из поддерживаемых Mylyn Wiki форматов в HTML. Я не нашел полезных онлайн-примеров, демонстрирующих, как использовать Java для написания кода для Mylyn WikiText. Я нашел только эту страницу на Eclipse, но она использует Ant. Я прошу некоторый пример кода.

1 ответ

Решение

Хотя вы всегда можете кодировать Ant Scripts и запускать их из Java, ниже приведен полный служебный класс, который я только что написал, который позволит вам преобразовывать вики-текст через различные основные языки, зарегистрированные для автономного развертывания WikiText.

Следует отметить, что самое простое, что нужно сделать, это загрузить автономное развертывание, развернуть его и прочитать API, чтобы увидеть, какие другие конфигурации вам нужно применить.

Преобразование WikiText в HTML

package com.stackru.mylyn;

import java.io.StringWriter;
import java.util.Set;
import java.util.TreeSet;

import org.eclipse.mylyn.wikitext.core.parser.MarkupParser;
import org.eclipse.mylyn.wikitext.core.parser.builder.HtmlDocumentBuilder;
import org.eclipse.mylyn.wikitext.core.parser.markup.MarkupLanguage;
import org.eclipse.mylyn.wikitext.core.util.ServiceLocator;

/**
 * Utility to parse Wiki Text of varying languages and convert to HTML.
 */
public final class ParseWikiToHTMLUtility {

    public static final String NAME_TEXTILE = "Textile";
    public static final String NAME_TRACWIKI = "TracWiki";
    public static final String NAME_MEDIAWIKI = "MediaWiki";
    public static final String NAME_CONFLUENCE = "Confluence";
    public static final String NAME_TWIKI = "TWiki";

    private ParseWikiToHTMLUtility() {
            /* Do not instantiate utility classes */
    }

    public static String parseTextile(String wikiText) {

            return parseByLanguage(NAME_TEXTILE, wikiText);
    }

    public static String parseTracWiki(String wikiText) {

            return parseByLanguage(NAME_TRACWIKI, wikiText);
    }

    public static String parseMediaWiki(String wikiText) {

            return parseByLanguage(NAME_MEDIAWIKI, wikiText);
    }

    public static String parseConfluence(String wikiText) {

            return parseByLanguage(NAME_CONFLUENCE, wikiText);
    }

    public static String parseTWiki(String wikiText) {

            return parseByLanguage(NAME_TWIKI, wikiText);
    }

    public static String parseByLanguage(String name, String wikiText) {

            return parseByLanguage(ServiceLocator.getInstance().getMarkupLanguage(name), wikiText);
    }

    public static String parseByLanguage(MarkupLanguage language, String wikiText) {

            StringWriter writer = new StringWriter();
            HtmlDocumentBuilder builder = new HtmlDocumentBuilder(writer);
            MarkupParser parser = new MarkupParser(language, builder);
            parser.parse(wikiText);
            return writer.toString();                
    }

    /**
     * MarkupLanguage API prefers we retrieve the MarkupLanguge by name from 
     * the ServiceLocator; since there are no name constants, we obtain the names 
     * from this method or alternately use the hard-coded names from this utility class, 
     * which were pulled directly from a prior call to this very method. 
     */
    public static Set<String> getLanguageNames() {

            Set<String> languages = new TreeSet<String>();
            for (MarkupLanguage s : ServiceLocator.getInstance().getAllMarkupLanguages()) {
                    languages.add(s.getName());
            }

            return languages;
    }        
}

Чтобы преобразовать из HTML, используйте HtmlParser.parse() метод. Отправить свой HTML как InputSource и предоставить DocumentBuilder цель. DocumentBuilder реализации включают в себя XslfoDocumentBuilder (для XSL-Fo и возможного преобразования в PDF или PostScript), DocBookDocumentBuilder (для формата Docbook) и классы, которые расширяют AbstractMarkupDocumentBuilder (есть один для почти каждой разметки: TextileDocumentBuilder, ConfluenceDocumentBuilder, так далее.).

Другие WikiText ссылки:

Другие вопросы по тегам