Skip to main content
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [incubation] (HTML) Documentation editor
Hi, David, Ed,

Looks like pandoc can convert MediaWiki to AsciiDoc?  Or is that perhaps a different AsciiDoc?


Christian


On 13 July, 2016 at 11:47:11, David Green (david.green@xxxxxxxxxxx) wrote:

Ed,

Agreed, it's not WYSIWYG but it does have features that help out with markup, such as a cheat sheet and formatting.  You can find out more here: http://help.eclipse.org/neon/topic/org.eclipse.mylyn.wikitext.help.ui/help/Getting-Started.html?cp=50_2_1_1#WikiTextEditorOverview

As for conversion to AsciiDoc, it's not currently supported.  WikiText does support generating files from within the IDE, e.g. to Confluence, Markdown or HTML, but this feature is not yet implemented for generating AsciiDoc.  More details can be found here:  http://help.eclipse.org/neon/topic/org.eclipse.mylyn.wikitext.help.ui/help/Markup-Generation.html?cp=50_2_3_0#GenerationInEclipse

David

On Tue, Jul 12, 2016 at 11:24 PM Ed Willink <ed@xxxxxxxxxxxxx> wrote:

Hi

I currently use Mylyn Textile (and quite like it). AsciiDoc looks to be a distinctly better markup since it has an unambiguous escape mechanism. Is there a Convert facility to migrate between markups?

It is a bit misleading to imply that Mylyn AsciiDoc (or ...) is WYSIWYG. There is a read-only preview / editable markup tab. WYSIWYG requires editing in the preview.

    Regards

        Ed Willink

On 12/07/2016 21:52, David Green wrote:
Jens thanks for the pointers, those look great.  I also prefer to have WikiText-based files as source, and generate Eclipse Help content from them.  Jens has some great links there, but you may also find these useful:


The documentation includes details of files-as-source, but also covers an alternate approach of using the Eclipse wiki as source (see mediawiki-to-eclipse-help in the docs).

David

On Tue, Jul 12, 2016 at 1:14 PM Jens v.P. <developer@xxxxxxxxx> wrote:
Dear Keith,

We are currently switching to Asciidoc (http://www.methods.co.nz/asciidoc/), using Asciidoctor (http://asciidoctor.org/) for tooling. It is supported by Mylyn’s WikiText (https://wiki.eclipse.org/Mylyn/WikiText/AsciiDoc), and we already create Eclipse Help, HTML pages, and PDF from a single source.

We are at the very beginning, and we have only migrated some user documentation, see https://github.com/NumberFour/n4js/tree/master/docs/eu.numberfour.n4js.doc. In the long run, we want to port our Latex based specification to Asciidoc and use that as the only format. For that, we are currently investigating custom macros (both for AsciiDoc and Mylyn Wikitext).

Regards,
Jens
_______________________________________________
incubation mailing list
incubation@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://dev.eclipse.org/mailman/listinfo/incubation
--


David Green | VP of Architecture | Tasktop

email: david.green@xxxxxxxxxxx



_______________________________________________
incubation mailing list
incubation@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://dev.eclipse.org/mailman/listinfo/incubation

_______________________________________________
incubation mailing list
incubation@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://dev.eclipse.org/mailman/listinfo/incubation
--


David Green | VP of Architecture | Tasktop

email: david.green@xxxxxxxxxxx

_______________________________________________
incubation mailing list
incubation@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://dev.eclipse.org/mailman/listinfo/incubation

Back to the top