Welcome Guest (Log in)

Make DocSet

StarStarStarStarStar
Utility (45) | Developer tool (32) | HTML (8) | LC 8+9 (8) | File paths (5) | Documentation (2) | URL (2)
General
Expander triangle
  • Author
  • Rating
  • Type
  • Revision
  • Downloaded
  • Updated
  • James Hale
  • StarStarStarStarStar
  • Stack
  • 20
  • 98 Times
  • 13 December 2017
A Dash docset creater for Livecode documentation
"Dash" is a documentation and snippet manager for MacOs and iOS.

The MacOS version of Dash is a paid for app.
The iOS version of Dash is FREE

Dash Docset readers also exist for:
Windows (Velocity & Zeal)
Linux (Zeal) and
Android (LovelyDocs).

"Make DocSet" requires LC 8.1.5 or above.
If you are using an ealrier version of LC just download the current community LC 8 or 9 to make the docset. The dictionary entries clearly state the version of LC that they refer to.
Note also that the API database structure was changed with LC8.2dp2 and LC9dp10.
I have put in place code to switch to a different dictionary access for these (and future) versions.

"Make DocSet" will extract all the guides, images, dictionary entries and release notes from the IDE and format them intto "html".

It will then construct a docset package on your desktop (or directory of choice) containing all the html files, images and SQlite index required by Dash.

To install into Dash (assuming you have a copy) just double click.
To install on yout iOS device, transfer the file via iTunes to the Dash app.

As the docs are updated in each release of LiveCode you can use the stack regenerate the docset, should you wish, to ensure your copy is up to date.

Version 2.2
„Include a summary table of entries associated with each object entry.

Version 2.1
„ New dictionary handlers for LC8.2+ and LC9Dp10+
„ Include the "library" name associated with the entry.

Version 2.0.1
„ Reinstate code block detection
„ Reinstate blockquote detection
„ correct version check to allow 8.2 +

Version 2.0
„ Complete reworking of extraction and formatting code
Now works directly on dictionary array
„ All library and Widget entries now include a summary list of associated
dictionary entries
„ All Datagrid entries listed under "Datagrid"
* Removed links in descriptions where multiple entries were possible and
correct one was ambiguous.

Version 1.9
„ Account for colon in name
„ Workaround for some errors in docs.

Version 1.8
- Script colorization in the Syntax and Example sections.
- Tidied up some formatting.
- Links to terms and other entries now limited to Summary, Changes,
Description and Related sections

Version 1.7
- Thanks to a suggestion from Monte Goulding in answer to a query about inserted line breaks in the ldoc files I have thrown out most of the V1.6 coding and substituting it with Monte's mergMarkdownToHtml external.
Works a treat and will probably be more robust.

Version 1.6
- Reworked formatting scripts to to handle description block as well as description blocks in Parameter and Value sections.
- Description blocks now handle correctly formatted code snippets.
- Description blocks now format lists (up to 2 levels) correctly.
- Reworked Examples section formatting to correctly group blocks of code.
- Added "Tags" values

Version 1.5
- fixed pesky "Related" entries, and tidied them up.

Version 1.4
- format for description section now correct.
- correct keyword lookup where multiple exists works again.
Note - dependent on a type being included in text as in
- Logo copyright info added.

Version 1.3
- Remove spurious heading from LCB entries
- Ensure entries with same name (but different domains) do not write
over each other.
- correct broken Guide links

Version 1.2

Note: Currently Dash does not recognise "glossary" nor "Control Structure"
as an entry type.
These entries are currently shown under the "Variables" entry in Dash.
I have written to ask these types be included.

- Bug fix on dictionary links appearing in description texts.
- Adjusted filenaming convention to correctly handle $ & [ and other
characters that require encoding but that does not interfere with hrefs.
- Special case for <>,<,>,<=,>= in sqlite index
- Modified interface, added release notes, moved plist and css to own pages
- Add ability to set location of docset
- Now deletes any previous docsets
- Progress indication.
- Really correctly corrected embarassing typo!


Version 1.1
- LC icon added.
- Table of contents added for Guides.
They will appear in the left pane when viewing a guide.

Version 1.0
- Initial release

Ajax Loader
Tags
Expander triangle
User Comments
Expander triangle