Submitted by KeithB on 2018/11/04 21:18
(I corrected the title from SNB to SNDB)  
Reference Paul's comment in [node:4313, title="Adjusting Tag Grid TEXT SIZE can cause Tag List to list [Item Font] instead of [Item]"]

 
 [quote=Pierre_Admin]
[quote=Paul_J_Miller]
I think it might be a good idea to have the InfoQube documentation downloadable as an InfoQube notebase.  This would also be a good demonstration of the power and versatility of the program.
[/quote]
It would be nice indeed, but IQ does not have that feature built-in and would probably be quite a bit of work...
I created standalone files for each chapter here: InfoQube Documentation: Main Page
Great for "bed-time" or "bus ride" reading 
  
Pierre_Admin
IQ Designer
 [/quote]
 
I was coincidentally putting a IQ file of the manual together for my learning purposes. I'm now happy with it, and it's time to share.
 It's a snapshot of the present state of the manual, and; I've been updating it per the "Doc updates" section. I think it's reasonably accurate, but I have some links and dates wrong/missing here and there.

 
 
Features/comments:
 
  • Everything's MHT, and it's a local copy. 
  • It's editable (if you can edit the MHT), so you can do markups of it. 
  • it's more versatile than the CHM, since you can utilize tags, and put in comment fields and such
  • Tags are colored green, to not get mixed up with other items, especially those of the same name
  • Level 1 and 2 are color coded with some garish colors as an experiment to recognize levels more easily. Pardon the colors (I've got deuteranomaly, so some strange colors appeal to my vision)
  • I've started loading tags in to experiment with. There are 160 in there so far; Some will show as properties, pane, propertiespane, stuff like that; I'm still working out what works best for me
  • I've got most of the dates in (it's a tricky manual operation, since the only place they appear are in the doc updates). It's nice to be able to see quickly the ancient stuff, some which is still relevant.
  • I think it will be a good "playground" for various experimentation.
  • I put in links to the online pages, which is really useful; find it via the superb searching tagging searching of iq, then go to the online copy.
  • I could see this being useful if someone just uses the outline only with the links
It's a bit of "manual" (no pun intended)  work to put it together, but I think it should be pretty easy to keep up-to-date now.

 
Please comment if you come up with improvements to your own copies. 
  The forum was being finicky, and once again says the maximum upload filesize is 16 MB, so here's  a link to the file in my Box Sync: 

 
Have fun slicing and dicing and tagging and live searching, etc!

Comments

Wow Keith !
 
This is excellent, thanks !
 
(I know you sent me this a while back but I didn't do anything with it, being busy with Tags et al... sorry)
 
 
Pierre_Admin
IQ Designer
 

DragonGem

2018/11/05 15:29

In reply to by Pierre_Admin

Keith, thanks for your time and effort in compiling this valuable resource!

I've taken the liberty of adjusting the Outline a little (personal preferences) and re-capturing a couple of missing MHT files (namely Tags). It's still a pretty big ZIP so you can download it hereapp.box.com/s/samdostcvbvp7pn48ol5ux3kq5js5m2e ).

I haven't worked much with MHT files as of yet. I like that the they work well offline with all the text and graphics stored locally. I dislike that I need to set [Lock to Item] ON in order to SCROLL and have to call up an external editor to do any markups. Transportation also requires compressing and making sure that all the folders are in their proper place. Too many trade-offs for my liking.

To that end, I've created a straight HTML version by Copy&Paste of the revised Outline and manually copying each Document over (took 20 minutes with a FastKeys macro). You have to be online to see the images but this format requires much less storage; ZIPs down to 836Kb. Documents are fully editable and transportation is simply copying the SNDB file.

Hopefully someone besides me will find this useful.

Pierre_Admin

2018/11/05 15:41

In reply to by DragonGem

[quote=DragonGem]

I haven't worked much with MHT files as of yet. I like that the they work well offline with all the text and graphics stored locally. I dislike that I need to set [Lock to Item] ON in order to SCROLL and have to call up an external editor to do any markups. Transportation also requires compressing and making sure that all the folders are in their proper place. Too many trade-offs for my liking.

To that end, I've created a straight HTML version by Copy&Paste of the revised Outline and manually copying each Document over (took 20 minutes with a FastKeys macro). You have to be online to see the images but this format requires much less storage; ZIPs down to 836Kb. Documents are fully editable and transportation is simply copying the SNDB file.

[/quote]

You guys are awesome !!
 
Regarding the downsides of MHT:
  • Scroll: Works fine here, both with the mouse wheel and cursor keys
  • External editor: True, sometimes useful as this basically opens the content in another window. great to have many editing windows open at once
  • Transportation: Should be completely transparent (as long as the files are in the .Files folder, which they currently are)
 
Pierre_Admin
IQ Designer
 

DragonGem

2018/11/05 16:49

In reply to by Pierre_Admin

Thanks for the MHT tips, Pierre. There certainly are times that I want to create a static webpage capture; especially when I have other uses for embedded images. I had been using RightNote for this but will investigate MHT more thoroughly.

I see your point about BlockNote potentially alleviating some of the problems I'm having with multiple IQ editors open simultaneously. Each BlockNote instance is independent of IQ, light on resources and reasonable well featured (lack of customizable shortcuts a bit of a problem).

Document scrolling isn't working (without [Lock to Item] turned ON) on any of 3 PCs I've been testing IQ on. Probably time for a complete re-install of IQ.

Pierre_Admin

2018/11/05 17:28

In reply to by DragonGem

WizHTMLEditor handles more complex documents than BlockNote can, so I tend to prefer it
 
Pierre_Admin
IQ Designer
 

KeithB

2018/11/06 21:45

In reply to by DragonGem

 This is fantastic feedback; exactly what I was hoping for.
 
Both versions:
 
1) I really like your tagging system of A,B,C, etc. After using adding that to mine, I see NO drawbacks whatsoever with regard to ease of keystroking. I guess there needs to be a tagging tips/suggestions thread created eventually.
 
2) I really like your outlining setup, such as 04 A 1-3, B 1-4, C. Those letters make things easier to read than the website of all numbers.
 
3) I also will incorporate your use of various sizes of bold.
 
4) This searching capability is even better than I imagined it would be.
 
SNDB local version:
1) your box sync zip file had the didn't have the sndb local file, but I assume the formatting would be just like the html version, and I imagine you have less columns than I had, but probably more than the html version. I think the date column is very important.
2) Thanks for the headsup on the missing page; I'm pleasantly surprised there was only one.
3) I'm thinking periodic updates won't be much of a problem, unless Pierre does some huge refactoring of the online manual. 
 
HTML version:
1) this version would always up to date, (unless Pierre new web nodes are added, or moves existing stuff around).
2) I had thought of creating the same thing, but didn't know exactly how to do that. 
Could you possibly give me a quick picture of what "by Copy&Paste of the revised Outline and manually copying each Document over" means?
 
A few of ideas for improvements:
1) I think I'm going to add a sortnumber column to mine; (I sorted on a column, and jumbled things up, so it was easier to go to a backup file.
2) It would be great for someone to take the time to go through an create more tags, especially with regards to the content, and not just mostly based on the title content, which is what I did.
 
Farther out:
1) integrate the online glossary in it, in a separate grid. However there's currently not much content in there, and it's quite old.
2) videos of everything, of course, linking to the (to-be-created) content on the youtube channel.
 

DragonGem

2018/11/07 00:17

In reply to by KeithB

Keith, glad you found my revisions useful. I certainly learned a lot about MHT from working with your IQ version.

SNDB : Sorry about the mixup on the IQManual-MHT.zip on box.com; it has been updated with the proper SNDB now. Other than the numbering and outline formatting, it should be virtually the same as your version. I did play around with resizing a few of the images to get a better feel for editng MHTs.

HTML : Only the images are pulled down from the web on document display; all the text and formatting is static and stored in the SNDB. With the latest advancements in IQ's Export to HTML capabilities, I suspect that Pierre will eventually end up using IQ to create the online documentation rather than visa versa.

I like your idea of a Sort Column; something like "02.A.6.a" I assume. I thought about incorporating that in the Item text but found it to be distracting. This can be a lot of work if your overall outline is "in flux".

VIDEOS : I've got a few IQ tutorials planned but I'll create a quick demo of how the Cut & Paste process works when I get a few minutes (more like an hour really). If you want a preview what my Instructional Tutorials tend to evolve into, you can view one on Using Styles in Microsoft Wordwww.screencast.com/t/q0Xe0na6DRKC ). 

 

Tom

2018/11/10 18:20

In reply to by DragonGem

[quote]
To that end, I've created a straight HTML version by Copy&Paste of the revised Outline and manually copying each Document over (took 20 minutes with a FastKeys macro). You have to be online to see the images but this format requires much less storage; ZIPs down to 836Kb. Documents are fully editable and transportation is simply copying the SNDB file.
[/quote]
 
when I click on the link for the SNBD file, I get this below -- interestingly enough, if I save that, it opens correctly in IQ
 

Pierre_Admin

2018/11/10 19:45

In reply to by Tom

Ha, ha, your browser is trying to show a binary file...
I removed the .SNDB link above, keeping only the .Zip version
 
HTH !
 
Pierre_Admin
IQ Designer
 

Tom

2018/11/11 17:45

In reply to by DragonGem

[quote] Attachment    Size
IQManual-HTML.zip    835.85 KB [/quote]
 
Pierre is it possible to get Tags to auto-group alphabetically as in DragonGem's version of the manual file (where I'm presuming it was manually grouped):
 

Pierre_Admin

2018/11/11 18:01

In reply to by Tom

Hi Tom,
 
I added it to the list of enhancements to Tags. This would be more useful than A-Z scroll buttons, as in typical address book applications ? (or music players)
Another enhancement which is on the list, is that parent items of tag items can themselves not be tags, so that in the above example, J, K, L would be shown, but without checkboxes
 
Pierre_Admin
IQ Designer
 

I have put together a short piece as a basic introduction for newcomers to some of the concepts and misconceptions which might trip them up.
 
InfoQube is a very good program but those first few steps can be huge and daunting.
 
Mainly due to not knowing where things are or what is possible.
 
This text is very much a starting point not an endpoint, please feel free to edit it.
 
It could also do with some screen shots.
 

KeithB

2018/11/06 06:23

In reply to by Paul_J_Miller

 This is a nice writeup. It almost reads like a script for a video introduction. Woiud you consider moving this to a new forum thread? I'm afraid this is going to get somewhat "buried" in this thread.

Paul_J_Miller

2018/11/06 10:15

In reply to by KeithB

My thinking was that this text could be put in the manual somewhere.  If Pierre thinks it suitable to be included.
 
I can put it in a separate forum post if thats what people want.

Tom

2018/11/06 13:23

In reply to by Paul_J_Miller

Something like this would be great in the (new) IQ file with sample data.
An intro with tutorial/s. So maybe an IQ file would be a better approach than HTML (?)
 
EDIT//
FWIW I think a separate thread might be a good idea as it may prompt a fair bit of discussion (maybe).

Paul_J_Miller

2018/11/06 15:19

In reply to by Tom

[quote=Tom]
Something like this would be great in the (new) IQ file with sample data.
An intro with tutorial/s. So maybe an IQ file would be a better approach than HTML (?)
 
EDIT//
FWIW I think a separate thread might be a good idea as it may prompt a fair bit of discussion (maybe).
[/quote]
 
It's HTML because it was copied from a document pane in InfoQube.
 
If there was symetrical import and export of .XML files I could have transferred it that way.
 

Pierre_Admin

2018/11/06 15:26

In reply to by Paul_J_Miller

If you give me permission, I'll definitely add it to the documentation
 
Pierre_Admin
IQ Designer
 

Paul_J_Miller

2018/11/06 18:59

In reply to by Pierre_Admin

[quote=Pierre_Admin]
If you give me permission, I'll definitely add it to the documentation
 
Pierre_Admin
IQ Designer
 
[/quote]
 
If you think it worthy of being there then of course you have my permission.

Paul_J_Miller

2018/11/07 06:09

In reply to by Paul_J_Miller

... and of course you can make any edits or alterations you want.
 

Paul_J_Miller

2018/11/08 07:15

In reply to by Paul_J_Miller

A point of clarification.
 
Concerning the second to last sentence of the section called 'A few concepts' just before the 'Taking Control' section.
 
I feel that it would be more perspicuous if it read :-
 
The Items in each Grid can be arranged into a hierarchy and you can show the Properties in columns.
 
Instead of :-
 
Each Grid can be arranged into a hierarchy and you can show the Properties in columns.
 

Hi All,
 
I'm finishing up an IQBase that links to the web site (forum), which will automatically sync and update when the documentation changes. Will be great learning tool !
 
No other information manager can do that !!!
 
HTH !
 
Pierre_Admin
IQ Designer