Differences between revisions 14 and 18 (spanning 4 versions)
Revision 14 as of 2016-06-15 21:20:49
Size: 2085
Editor: KaiJaeger
Comment:
Revision 18 as of 2018-03-03 11:40:57
Size: 116
Editor: KaiJaeger
Comment:
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
~-<<SeeSaw(section="table-of-contents", show="true", seesaw="false", toshow="<<(Show>> table-of-contents)", tohide="<<(Hide>> table-of-contents)", speed="Slow")>>-~
<<TableOfContents>>

`Markdown2Help` is part of the CategoryAplTree project.

== Overview ==

This application allows you to create a CHM-like help file (including an "Index" and a "Search" tab) by simply creating variables that hold Markdown text defining a help page. This makes you completely independent from any 3rd-party tools for creating and maintaining help files.

It has the benefit of allowing you to edit your help pages while developing or tracing your application.

Note that the now outdated project `APLTreeHelp` offered exactly the same functionality. The difference is that in `APLTreeHelp` help pages were represented by dynamic functions returning a vector of vectors with tags and text. Markdown has significant advantages when it comes to editing a help page. That's why `APLTreeHelp` was replaced by `Markdown2Help`.

This is what `Markdown2Help`'s own help page looks like:

{{attachment:Markdown2Help_01.png}}

To give it a try just download `Markdown2Help`, unzip it, load it into a Dyalog session and call this function:

{{{
      #.Markdown2Help.Selfie 1
}}}

If you want to investigate `Markdown2Help`'s own help pages look into `#.Markdown2Help.HelpHelp` via the Workspace Explorer:

{{attachment:Markdown2Help_02.png}}

Note how the namespaces reflect nodes and the variables reflect help topics.

This is what a typical help variable looks like:

{{attachment:Markdown2Help_03.png}}

There will be soon an article in Vector regarding `Markdown2Help`.

== Requirements ==

`Markdown2Help` needs at least version 14.0.

== Project Page ==

For bug reports, future enhancements and a full version history see [[Markdown2Help/ProjectPage]]

== Version Information ==
||Original author: ||KaiJaeger ||
||Responsible: ||KaiJaeger ||
||Email: || kai@aplteam.com ||

<<Include(APLTreeDownloads)>>

----
CategoryAplTree
The project has been relocated to [[https://github.com/aplteam/Markdown2Help]] on 2018-03-03.

Markdown2Help

The project has been relocated to https://github.com/aplteam/Markdown2Help on 2018-03-03.

Markdown2Help (last edited 2018-03-03 11:40:57 by KaiJaeger)