Dictionary rewrite - thoughts, please
Moderators: FourthWorld, heatherlaine, Klaus, kevinmiller
-
- Posts: 52
- Joined: Mon Jun 24, 2013 4:10 am
- Location: Hawaii
- Contact:
Re: Dictionary rewrite - thoughts, please
OK... not waiting for more talk... have at it on the GUI here:
https://www.figma.com/file/eLKlg073BC1A ... ry-Designs
Don't ask permission to change it.. just make it better
https://www.figma.com/file/eLKlg073BC1A ... ry-Designs
Don't ask permission to change it.. just make it better
Re: Dictionary rewrite - thoughts, please
I've unleashed a monster, lol
-
- Posts: 52
- Joined: Mon Jun 24, 2013 4:10 am
- Location: Hawaii
- Contact:
Re: Dictionary rewrite - thoughts, please
I added a screen shot of the dictionary pre 8... anyone else have a screen shot of BG;s dictionary? I'll try to install that here.
Perhaps we can all list what we like/want in broad strokes without thinking initially about how the UI will "do it"
Perhaps we can all list what we like/want in broad strokes without thinking initially about how the UI will "do it"
-
- Posts: 52
- Joined: Mon Jun 24, 2013 4:10 am
- Location: Hawaii
- Contact:
Re: Dictionary rewrite - thoughts, please
maybe bjoernke just needs help to bring his old dictionary up to 8.1.3? I loved it.Mikey wrote:What up, BG?
-
- VIP Livecode Opensource Backer
- Posts: 9833
- Joined: Sat Apr 08, 2006 7:05 am
- Location: Los Angeles
- Contact:
Re: Dictionary rewrite - thoughts, please
Rather than work with it directly, when I was exploring the possibility of writing an alternative Dictionary I found the IDE's API call for querying by token to return an array. I can't recall what it is offhand (I'll have to dig it up from notes), but I found it in the Script Editor's Documentation pane.Brahmanathaswami wrote:Putting this in for the record: Path to dictionary goes like this in LC for Mac... we probably need to be using special folder path.
Applications/LiveCode Business 8.1.3 (rc 1).app/Contents/Tools/Documentation/html_viewer/resources/data/api/api.sqlite
The array it returns is really great - very tidy, very complete. Well worth considering, since that chunk of the work has already been done, so folks working on this project can focus on UI.
Richard Gaskin
LiveCode development, training, and consulting services: Fourth World Systems
LiveCode Group on Facebook
LiveCode Group on LinkedIn
LiveCode development, training, and consulting services: Fourth World Systems
LiveCode Group on Facebook
LiveCode Group on LinkedIn
Re: Dictionary rewrite - thoughts, please
Right. In all likelihood the data structures are fine.
-
- Posts: 52
- Joined: Mon Jun 24, 2013 4:10 am
- Location: Hawaii
- Contact:
Re: Dictionary rewrite - thoughts, please
More input from HQ (Elanor):
Re field "entry-data" blob in the api.sqllite dbase: Yes, it is an encoded LiveCode array, you can use arrayDecode to turn the blob
data back into a LiveCode array. I suggest you have a look at the `revIDEDocumentationLibrary` stack. It may be that that you don't need to access the database directly and the API can provide the information that you need.
Yep agreed, we an focus on UI...
Re field "entry-data" blob in the api.sqllite dbase: Yes, it is an encoded LiveCode array, you can use arrayDecode to turn the blob
data back into a LiveCode array. I suggest you have a look at the `revIDEDocumentationLibrary` stack. It may be that that you don't need to access the database directly and the API can provide the information that you need.
Yep agreed, we an focus on UI...
Re: Dictionary rewrite - thoughts, please
At some point I think making the db more obvious/easier would be a good thing to do, but after we do the first work.
-
- VIP Livecode Opensource Backer
- Posts: 1236
- Joined: Sat Apr 08, 2006 1:10 pm
- Location: Zurich
- Contact:
Re: Dictionary rewrite - thoughts, please
Well, actually I need anyone else to do it, 'couse most likely I won't be able to do it.Brahmanathaswami wrote:maybe bjoernke just needs help to bring his old dictionary up to 8.1.3? I loved it.Mikey wrote:What up, BG?
The current IDE dictionary stack is not that different from the old (xml) way it was done, the main difference is that the text itself is not livecode style htmltext, but some form of markup (of which they don't know all the specifics themselves: "we used some php script", note that they also made their own additional markup, mostly to have sub-divisions).
Basically if you want to update bvg docu and call it MikeyDocu, all you'd need to do is a markup interpreter to get htmltext out of the existing dictionary. It's probably not a huge amount of work.
Various teststacks and stuff:
http://bjoernke.com
Chat with other RunRev developers:
chat.freenode.net:6666 #livecode
http://bjoernke.com
Chat with other RunRev developers:
chat.freenode.net:6666 #livecode
Re: Dictionary rewrite - thoughts, please
What do we like about the new dictionary?
Re: Dictionary rewrite - thoughts, please
Here's another great (but phase 2) suggestion, and Ali should get the credit for it: When there is an issue with the documentation, for example http://quality.livecode.com/show_bug.cgi?id=19192, the person who is filing the issue should be able to fix the entry in their dictionary and submit the correction. If we could magically turn that into a pull request, even better.
Re: Dictionary rewrite - thoughts, please
Next thing to think about: Would it be faster/easier/cheaper/better to (try to) "just" switch frameworks? I haven't tried it, or thought about trying it until last night when I was poring over all the...stuff...that went into making the documentation the way it is, now.
Re: Dictionary rewrite - thoughts, please
or what about going completely nuts and converting everything to run in dash and zeal?
Here's one discussion: https://codetuts.tech/tools-to-read-off ... mentation/
Similar to the idea of editing your scripts in a text editor http://beebom.com/best-text-editors-for-mac/ because they are better text editors than the script editor, and they are constantly being worked on, this would make for one less thing the team/community has to maintain.
Launching the external documentation viewer would be a matter of having a preference pointing to the viewer, then when you hit the api menu item, launching it.
Here's one discussion: https://codetuts.tech/tools-to-read-off ... mentation/
Similar to the idea of editing your scripts in a text editor http://beebom.com/best-text-editors-for-mac/ because they are better text editors than the script editor, and they are constantly being worked on, this would make for one less thing the team/community has to maintain.
Launching the external documentation viewer would be a matter of having a preference pointing to the viewer, then when you hit the api menu item, launching it.
Re: Dictionary rewrite - thoughts, please
Also per Ali,
The database is built from the .lcdoc files and from the extracted inline LCB docs by the revDocsParser script - each of the binary blobs is just the docs data in a livecode array, encoded using arrayEncode.
I suggest using the API in revIDEDocumentationLibrary to access the database, or extending it there if there are any functions missing.
You *probably* don't need to know much about the docs generation, unless you do, in which case it is a combination of revDocsParser and the docs builder https://github.com/livecode/livecode/bl ... codescript
The current dictionary uses json instead of the database, but they are both generated from the same array of docs data, so they should be the same, essentially. It would be good to get rid of the json data entirely, as it's obviously harder to add to / remove from dynamically (as happens when eg a widget is loaded), and doesn't hepl with searching etc.
The database is built from the .lcdoc files and from the extracted inline LCB docs by the revDocsParser script - each of the binary blobs is just the docs data in a livecode array, encoded using arrayEncode.
I suggest using the API in revIDEDocumentationLibrary to access the database, or extending it there if there are any functions missing.
You *probably* don't need to know much about the docs generation, unless you do, in which case it is a combination of revDocsParser and the docs builder https://github.com/livecode/livecode/bl ... codescript
The current dictionary uses json instead of the database, but they are both generated from the same array of docs data, so they should be the same, essentially. It would be good to get rid of the json data entirely, as it's obviously harder to add to / remove from dynamically (as happens when eg a widget is loaded), and doesn't hepl with searching etc.
-
- VIP Livecode Opensource Backer
- Posts: 4000
- Joined: Sun Jan 07, 2007 9:12 pm
- Location: Bochum, Germany
Re: Dictionary rewrite - thoughts, please
Hi all,
here is a very preliminary stub of a stack that reads from stack "revIDEDocumentationLibrary" the array with the dictionary information, puts it into a modifiedTableField (homegrown).
This happens on preopencard, so there is a slight delay when opening the stack.
Clicking on a line or moving with the arrowKey up/down shows the details in a field below. The field entries are not formatted yet. No hyperlinks etc.
Sort by clicking in header, search using search field. Empty search field restores whole dictionary.
Just to show how easy it is to get at the information.
Kind regards
Bernd
here is a very preliminary stub of a stack that reads from stack "revIDEDocumentationLibrary" the array with the dictionary information, puts it into a modifiedTableField (homegrown).
This happens on preopencard, so there is a slight delay when opening the stack.
Clicking on a line or moving with the arrowKey up/down shows the details in a field below. The field entries are not formatted yet. No hyperlinks etc.
Sort by clicking in header, search using search field. Empty search field restores whole dictionary.
Just to show how easy it is to get at the information.
Kind regards
Bernd
- Attachments
-
- dictionaryStackQuickHack.livecode.zip
- added search
- (39.59 KiB) Downloaded 281 times