The understanding of TW

[Luis Gonzalez]

I am analyzing the behaviour of TW as a standalong file, but I can't understand why the browsers can work with it.


I understand some things:

• node.js is the key concept.
• It has two ways: installing node.js and as a standalone html page.
• It runs in all new browsers with:
• html5
• javascript
• more needs?
  

and:

When a browser loads a page:

• It loads the html file.
• It parse it and generates the DOM.
  
• It runs the scripts
• It loads the css styles

But if TW needs node.js to run, where is node.js in Firefox and Mac-Safari?

I read the html file with notepad.exe and I found the bootprefix.js and boot.js, but no more elements.

I have many questions:

• What elements node.js put in the single html tw?
• Is posible to change the core english language tiddlers with other languages to generate a "native non-english" tiddlywikis?
• Is posible to generate the wiki with less elements?
• What elements are "dispensables" and what functionalities would be suppresed?
• Could we make a timeline of the TW load in a browser?
  

These are questions to understand this WONDERFUL wiki and to unravel its operation so that more people can collaborate developing quality code.

Can you help me?

Thanks!!!!!

[PMario]

On Tuesday, May 30, 2017 at 9:59:29 AM UTC+2, Luis Gonzalez wrote:

I understand some things:

• node.js is the key concept.

node.js is only needed, to build the SPA (Single Page App) eg: empty.html with a command line utility that is named "tiddlywiki"

node.js is not needed if you start empty.html in the browser.  ... The file is "self contained" no other dependencies.

tiddlywiki CLI (command line tool) has an option to start a server. eg: tiddlywiki mywiki --server. Where mywiki is the name of an edition. If a tw server is started that way, nodejs is needed.

• It has two ways: installing node.js and as a standalone html page.

see above. node.js is not needed if you want to run tw in the browser.
 

• It runs in all new browsers with:
• html5
• javascript
• more needs?

CSS
 

and:

When a browser loads a page:

• It loads the html file.
• It parse it and generates the DOM.
  
• It runs the scripts
• It loads the css styles

 That's basically the basic process every html page uses. ... But the main work is done in boot.js. That's where the real magic happens. boot.js "extracts" the core plugin, which contains all the other javascript modules, UI templates and base CSS. .... That's the initial delay, that you see, when you start the page.
 

But if TW needs node.js to run, where is node.js in Firefox and Mac-Safari?

no nodejs needed as written above
 

I read the html file with notepad.exe and I found the bootprefix.js and boot.js, but no more elements.

Yes. These are the main startup routines. .. Understanding them is "kind of a challenge" :)
 

I have many questions:

• What elements node.js put in the single html tw?

none
 

• Is posible to change the core english language tiddlers with other languages to generate a "native non-english" tiddlywikis?

There are 21 language plugins. If you download empty.html and open the ControlPanel: Plugins:  ... click: "Get more plugins" button ... a modal will open with an: "open plugin library" button ... click it and select the "language" tab, to see the languages, you want to import. 

• Is posible to generate the wiki with less elements?

Yes. This would be called a new "theme". Creating a new "base - theme" from scratch will need a lot of internal knowledge, but it is possible.
 

• What elements are "dispensables" and what functionalities would be suppresed?

 You can remove everything, but it wouldn't be very useful.

• Could we make a timeline of the TW load in a browser?
  

I don't understand this question.

hope that helps

have fun!
mario

[PMario]

On Tuesday, May 30, 2017 at 10:58:18 AM UTC+2, PMario wrote:

 

I have many questions:

• What elements node.js put in the single html tw?

none

I probably didn't understand that question right :)

When we build eg: empty.html with the --build command we basically add

 - the core:  https://github.com/Jermolene/TiddlyWiki5/tree/master/core
 - and we use this recipe. https://github.com/Jermolene/TiddlyWiki5/blob/master/editions/empty/tiddlywiki.info

to create the html file.

If you want to build and develop new TW functions, you should work with a fork of tw5 github repo. ...

-mario

[joseaug...@gmail.com]

Hi Luis,

I'm new in the TW community but I'll try to answer your question in general.

You can find the best documentation about the behaviour of TW in http://tiddlywiki.com/dev/

You only needs a html file with the code of TW and a web browser to use it. All is inside the file, all is organized in tiddelrs and it works parsing the tiddlers and render them in the browser.

Also is possible to use it with node.js, but is only an option. It have advantages and disadvantages, but this is another story.

Another possibility is to use TW desktop, I never use it, and I can't explain anything about it, appart of it works like an app in your desktop o laptop.

I'm sorry for my mistakes, but this is that I've understood until now.

Regards,
Jose