Dash docset creator for LiveCode
Posted: Mon Sep 11, 2017 5:59 pm
For those that came in late...
We are now up to version 3.2
See the bottom of this post for the full version history.
I have just uploaded a stack "Make DocSet" to revonline that creates a "LiveCode.docset" for use in the documentation/snippet manager Dash
https://kapeli.com/dash
Non Mac readers of Dash docsets include:
Windows:
Velocity <http://velocity.silverlakesoftware.com/>
Linux (and Windows):
Zeal <http://zealdocs.org/>
Android:
LovelyDocs <https://apkmonk.com/app/com.lovelyhq.an ... ovelydocs/>
From the revOnline entry:
"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!
This stack was made using LC 8 (business)
"Make DocSet" will extract all the guides, images and all the dictionary entries in the IDE and format them into "html".
It will then construct a docset package on your desktop with 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.
I have also posted a documentation set to the "User-Contributions" site so it is directly downloadable from within Dash and the other readers (I think )
You can try out Dash and see if it is helpful.
It can access/download over 150 documentation sets.
James
Version 3.3
• Finally completed "associations" linking algorithm for missing links.
Please report if any are still not working.
Version 3.2
• Corrected spacing and layout in Syntax examples.
• Enabled syntax coloring for code examples embedded in descriptions.
Version 3.1
• Corrected spacing and layout in code examples.
Version 3.0
• "Assocations" entries now link to appropriate master entry.
For example, if you look up "width" you will see it has the associations
[stack,card,field,button,graphic,scrollbar,player,image]
If you now click on "button" you will see the OBJECT entry for button
listing all its associated properties etc.
Version 2.9
• Script colorization returns to the Syntax and Example sections
Version 2.8
• Now includes the "Extension" guides introduced in LC 9.01
Version 2.7
• Adjusted guide conversion to display all headers in left panel. Previously only level 2 headers were included, but this left access to many sections within the guides difficult. This means there is effectively a table of contents based on all header text within the document. Unifortunately due to non existant standards for writing the guides, many extra and redundant entries are presented.
Version 2.61
• Left a breakpoont set (oops)
Version 2.6
• Adjust LC version to catch the 9 series
Version 2.5
• Adjust internal cross ref to account for change of widget libray type to "module"
Version 2.4
• Fixed keyword index for database
(Control structures now appear under the key phrase "Control Structures".)
Version 2.3
• Adjust script to summarise once more all library and widget associations under their respective entries.
• Note that under the widget entries, some properties/mesages are present due to the docs being wrong!
Version 2.2
• Include the "object" name associations with the entry.
Version 2.1
• New dictionary handlers for LC8.2+ and LC9Dp10+
• Include the "library" name associations with the entry.
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 summarised 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 <keyword(type)>
* 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 icons added
• Table of contents for guides added.
They will appear in the left pane when viewing a guide.
• Embarassing typo corrected
Version 1.0
•Initial release
We are now up to version 3.2
See the bottom of this post for the full version history.
I have just uploaded a stack "Make DocSet" to revonline that creates a "LiveCode.docset" for use in the documentation/snippet manager Dash
https://kapeli.com/dash
Non Mac readers of Dash docsets include:
Windows:
Velocity <http://velocity.silverlakesoftware.com/>
Linux (and Windows):
Zeal <http://zealdocs.org/>
Android:
LovelyDocs <https://apkmonk.com/app/com.lovelyhq.an ... ovelydocs/>
From the revOnline entry:
"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!
This stack was made using LC 8 (business)
"Make DocSet" will extract all the guides, images and all the dictionary entries in the IDE and format them into "html".
It will then construct a docset package on your desktop with 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.
I have also posted a documentation set to the "User-Contributions" site so it is directly downloadable from within Dash and the other readers (I think )
You can try out Dash and see if it is helpful.
It can access/download over 150 documentation sets.
James
Version 3.3
• Finally completed "associations" linking algorithm for missing links.
Please report if any are still not working.
Version 3.2
• Corrected spacing and layout in Syntax examples.
• Enabled syntax coloring for code examples embedded in descriptions.
Version 3.1
• Corrected spacing and layout in code examples.
Version 3.0
• "Assocations" entries now link to appropriate master entry.
For example, if you look up "width" you will see it has the associations
[stack,card,field,button,graphic,scrollbar,player,image]
If you now click on "button" you will see the OBJECT entry for button
listing all its associated properties etc.
Version 2.9
• Script colorization returns to the Syntax and Example sections
Version 2.8
• Now includes the "Extension" guides introduced in LC 9.01
Version 2.7
• Adjusted guide conversion to display all headers in left panel. Previously only level 2 headers were included, but this left access to many sections within the guides difficult. This means there is effectively a table of contents based on all header text within the document. Unifortunately due to non existant standards for writing the guides, many extra and redundant entries are presented.
Version 2.61
• Left a breakpoont set (oops)
Version 2.6
• Adjust LC version to catch the 9 series
Version 2.5
• Adjust internal cross ref to account for change of widget libray type to "module"
Version 2.4
• Fixed keyword index for database
(Control structures now appear under the key phrase "Control Structures".)
Version 2.3
• Adjust script to summarise once more all library and widget associations under their respective entries.
• Note that under the widget entries, some properties/mesages are present due to the docs being wrong!
Version 2.2
• Include the "object" name associations with the entry.
Version 2.1
• New dictionary handlers for LC8.2+ and LC9Dp10+
• Include the "library" name associations with the entry.
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 summarised 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 <keyword(type)>
* 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 icons added
• Table of contents for guides added.
They will appear in the left pane when viewing a guide.
• Embarassing typo corrected
Version 1.0
•Initial release