Newb Q's: Setting Up (Organizing) My TBox

Hey - some really basic questions.

I need to set up a bit of organization as I begin (linear, visual thinker here). I do understand it will develop as I go along. I have worked my way through Dr Bernstein’s helpful “Getting Started…” pdf but can’t seem to figure out how to do something really basic.

My TBox will use a home page from which everything will connect, rather than separate files for different topics. I have that home page and a basic structure of containers in an adornment set up there.

I now want to add the next level. I go into my Topics container and add my first topic note. What do I do to that topic note so that when I click on it, it will connect me to a new map?

TIA

Let’s suppose your “home“ container is “Reading”, and the note you have just made is “Medieval Reading Practices”. One way to proceed would be to drag “Medieval” into “Reading” in map view. In Outline view, you’d put it below Reading and indent one level.

Thank you. I organized using outline view; I returned to map view and the notes are not there.
I returned to my TBox home file and the containers are missing from inside the adornment (which I understand not being part of the outline) so the file inside the container, that I want to take me to a new map, is not there either.

Using your example:
My single file is Reading.
One of the containers (inside an adornment) is Medieval Lit. When I click on it, it should take me to a new map.
Inside the Medieval Lit container, or its new map. is a note, Medieval Reading Practices (MRP)
When I click on MRP I’d like another new map to open on which I can add my MRP info.
I imagine from it there will be other notes linking me more new maps… every one moving down a level.

I think something is off on my ‘levels’; I will return to the outline view and see if I can figure it out.

OK… so everything is in Outline view but gone from Map view.

Finding it. Thanks for your help.

You might find it useful to read this, to help understand the relationship between Outline and Map. They are but two of Tinderbox’s many views but are the two shown in a new document. You can change the views type of a tap, or if you’d like several different views available at the same time, open a new tab (‘+’ at right end of the tab bar) and set the addition view type desired. You may also have multiple tabs of the same view type (this often happens in different views are scoped to show only (different) parts of the current document.

Some app-related terminology that might help when communicating in the forum (so people don’t misunderstand one’ intent):

  • The app is called ‘Tinderbox’ with no capitals except at the beginning (not TinderBox as sometimes assumed.
  • The app name is not normally abbreviated, but if it is the normal usage is ‘TB’
  • The file type extension of Tinderbox files is ‘.tbx’ and so ‘TBX’ is a common shorthand for a document.

No critique at all in the latter but ‘Tbox’ above, read in context, could suggest either the app or a document. The suggestions above can help users better understand what is being asked. But, please don’t feel there are ‘rules’ about this. :slight_smile:

Thank you for reaching out; the info at “this” is beyond me at this point. But I will get back to it (I immediately have no idea why my outline view looks so different, and how to make mine look like that). I am grateful for that link as it reminded me of the TbRef site map. Thank you.

But I am trying to figure out simple/beginning things like:

  • how to make note titles automatically centre in map view. I found the document settings option but that didn’t centre them (it centered the notes in the ‘side bar’) and I can’t see anything else that might work. Is it not possible to centre note titles in map view? Perhaps it’s possible by creating a prototype?

  • prototypes: I have created a note that I’d like to become a prototype; opened the inspector; went through each of the tabs but seem unable to find where/how to lock in the centered title and color (which is all I want). I did search the TbRef site map prototype section but wasn’t able to find what I’m trying to do.

Thanks again for responding.

Inspector: Title Inspector: Center

AAHHH!! Thank you!!

Just created a new note and it didn’t automatically centre.
So do I need to add this to my note prototype, so all new notes automoatically centre the text?

Yes. Under the hood you are setting the system (i.e. built-in’) attribute NameAlignment. The default for this in a new TBX document is left and allowed choices are left, center, or right.

The Appearance Inspector, as show 2 posts above, changes $NameAlignment in the selected note(s). As you suspect, if you’d like all notes using a prototype to have the same $NameAlignment value, you set a value of center in the prototype. As you’ve probably already set a value locally some notes using the prototype, you can use an agent to ‘reset’ the inheritance. Let’s assume the prototype is called ‘pTask’ (you can substitute your own name in the example code). Make an agent:

Query: $Prototype=="pTask"
Action: $NameAlignment

Now, all notes using the prototype will not one look the same as the prototype but if you change the prototype’s $NameAlignment value, all those notes will change. Otherwise, notes where you set a $NameAlignment value in the note won’t change. This because the local value trumps the inherited prototype value. I cover this as it is very easy (experience is no help in this) to set a value in a note when you mean to set it in the note’s prototype. :slight_smile:

A separate case might be that you want all note in the TBX file to use the same, non-default, $NameAlignment value? For that we edit the attribute document level default in a different part of the Inspector, in the Document Inspector’s ‘system’ sub-tab. Open that Inspector and select the NameAlignment attribute to display its settings:

To make all (new) notes in the document use a centred title alignment, you’d set a value of center. Again, you might want to reset all local values of $NameAlignment (notes, prototypes notes) so inheritance of this is restored.

Probably too detailed for this moment, but aTbref has some detailed notes on inheritance of attribute values and prototypes for when you feel ready to delve a bit deeper. There is a lot of info in the section on Inheritance of attribute values; dip into it and return to clarify what you’re learning from using the app. Same with the Map vs Outline part, it’s there to help fill out or correct one’s understanding of the topic. Certainly, these are not a requirement to understand before using!

†. Here I’m using a $-prefix in the colloquial sense of indicating I’m referring to an attribute name, as opposed to its use in action code, where it means “get the value of this attribute”. For ‘single word’ attribute names such a prefix can help when explaining things; for instance, to clarify using the word 'Price ’ vs. ‘$Price’ as being an attribute of that name.

1 Like

Can’t thank you enough, Mark. Just what I needed. Thank you!

1 Like

… except I made an error while trying to create a prototype that deleted all notes’ visibility (still have info in outline view). When I click around in a blank map area I accidentally find ‘shadows’ of previous Notes (image below), so I think/hope they might still be there.

Now in trying to make a new note, I get this… and when I click outside this, it diappears. In Inspector I tried re-instating a border but that didn’t solve it. I think the prototype that caused this is doing what I asked it to (I hit delete to cancel my last action, which deleted all my notes - I know why) but I can’t find that prototype to fix things… as it’s doing what I (accidentally) asked it to do (?). I did open Window>Prototype Inspector but that didn’t help me find it.

TIA

You likely made the default color of the prototype note “transparent”! :slight_smile:

1 Like

If the last is the case how to fix? Try this agent…

Query: `$Color==”transparent”`

Action: `$Color=;`

Unless, of course you set the document default for $Color. In that case you’ll need to use the Document/system Inspector to set more useful default value