kookma links management

141 views
Skip to first unread message

Douglas Glenn

unread,
Dec 19, 2020, 8:58:31 PM12/19/20
to TiddlyWiki
Greetings Mohammad,

Just a FYI if you have the time to correct them anytime soon.

From the link in your recent entry of Refnotes in the Tiddlywiki under the Resources tiddler, you updated it 20 Nov 2020, but but the link referenced: 

This resulted in a 404 error. 
This link works.

On that page, the installation link did had the same 404 error

I noticed someone had made a change an hour before I logged onto Github yesterday. The video link was still there when I visited but I note it's gone today.




Douglas Glenn

unread,
Dec 19, 2020, 9:08:45 PM12/19/20
to TiddlyWiki
Mohammad,

Your tutorial says:

It is recommended to use the official Bibtex Importer plugin for using with bibliography code.

I cannot find it.

Note: The sidebar Bibtex tab can also be used for details of bibliography macro.
I don't have this tab.

Now I just have to learn how to use it 
:-)

Mohammad Rahmani

unread,
Dec 19, 2020, 11:44:24 PM12/19/20
to tiddl...@googlegroups.com
Hi Douglas,
 Many thanks for your feedback. I have corrected the issues. The official plugins can be installed from $:/ControlPanel, Plugins tab using "Get more plugins". These plugins are distributed with Tiddlywiki.

Refnotes will have an overhaul after TW 5.1.23 is released. Notably support for different styles (book, journal, dissertation, website, conference paper,...) better view template for bibtex entry and Node.js version are among new features. I will then correct the documentation and tutorial.


Best wishes
Mohammad


--
You received this message because you are subscribed to the Google Groups "TiddlyWiki" group.
To unsubscribe from this group and stop receiving emails from it, send an email to tiddlywiki+...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/tiddlywiki/09b464b5-6608-4368-9105-36615966f0d6n%40googlegroups.com.

Douglas Glenn

unread,
Dec 20, 2020, 3:50:06 PM12/20/20
to TiddlyWiki
Wow, it shows up now (bibtex importer). I don't know how I missed it. I had tried to install it by downloading each script in the Content tab on your Refnote site and importing it on my end. I managed to create one Bibliography tiddler, but only after observing how you had done it in  your examples (AMADEO1995949). Try as I may, the only Bibtex reference that syntax was on bib...@tug.org, written by Oren Patashnik 9 Feb 1988 titled BibTEXing. With examples like:

@INPROCEEDINGS(no-gnats,
crossref = "gg-proceedings",
author = "Rocky Gneisser",
title = "No Gnats Are Taken for Granite",
pages = "133-139")
. . .
@PROCEEDINGS(gg-proceedings,
editor = "Gerald Ford and Jimmy Carter",
title = "The Gnats and Gnus 1988 Proceedings",
booktitle = "The Gnats and Gnus 1988 Proceedings")

Since I only obtained a BA, I had not gone further and possibility being exposed to the syntax for a Masters or Doctorate degree. Research I learned and think I do fairly well with, left me ignorant of how it should be expressed. There was a Bibtex editor available to me, but it outputs:

Bibtex.jpg

Would I just start each field name with bibtex- (output field here) ? The example I spoke of, a few fields have bibtex-(field name) but others do not. Please excuse my ignorance but the Refnotes Tiddlywiki only increased my confusion. It's aimed at a more experienced Tiddlywiki user familiar with filters, ect, but for a raw novice such as myself who simply wants to install it and run with it, but it isn't explicitly clear that its output is predicated on a field, value  pair vs within the editor.  

I downloaded the reference above from the Refnotes site as a tid and imported it. Happily enough the fields used in the example now show under User Fields for selection. Consider this an enhancement request for pre-populating those fields under Bibtex Field separator/category when the plugin is installed. The addition of these as a selection under Bibtex fields (not User fields) would be invaluable to a novice such as myself. It may or may not be doable because simply deleting the plugin (under removing plugins instructions on the Tiddlywiki.com) would likely leave the field selections still available in the field selection dropdown. Perhaps if you had another entry under the plugin Content label, you could create the addition of a shadow tiddler that would contain these fields and link them to the core fields in order to remove the fields when removing the plugin.

As an IT support/admin and BA from the late 80's to present day, One lesson I learned that has served me best.  As a naturally lazy individual I'd always sought to find methods that would automate my job, or reduce any support load I had to handle. That lesson was to 'dumb down' the documentation to the end users level. All too many times documentation is non-existing or lacking. I hated writing documentation, but as I discovered it made my job so much easier I succumbed to the habit of creating it to meet the need to keep support calls with the end user or the Help Desk so the calls didn't need to be pushed up to my level to handle. 

A little more detail in your documentation in addition to pre populating the bibtex fields would greatly increase the use, popularity and value of your plugin. I mean no offense, but I do admit being lazy.

Have a great day safely with you and yours.
Doug

Mohammad Rahmani

unread,
Dec 20, 2020, 11:23:45 PM12/20/20
to tiddl...@googlegroups.com
Hi Douglas,

 I will hopefully work on Refnotes documentation to help newbies find their way easily. But just to answer your questions above

1. Refnotes has three small tools
1.1. abbreviations (to insert abbreviations and create glossary table)
1.2. footnotes (to insert numbered footnote in the tiddler body and create at the bottom of the tiddler full length footnotes)
1.3. bibliography (to insert references, and create bibliography table)

To use it:

1. drag and drop the Refnotes to your wiki
2. install Bibtex importer (not required but automate things)

i. Normally people use some libraries to get the bibliography data. Almost any library support bibtex format, so you need to export bibliography data as .bib files
ii. import the bibliography data (.bib files to your wiki. Bibtex Importer gets the data and generates bibtex entry tiddlers with all required fields (automatically)
iii. you can now cite using simple Refnotes macro

That's all. 

Refnotes plugin does not manually create bibtex entries nor encourage to do that! Bibliography data can be retrieved from a library like Google Scholar, sciencedirect.com, library of congress, ... 

But as an enhancement, I can add a macro to get data from the user and all the user to create a bibtex entry manually 

Hope this helps you and answers some of your questions.



Best wishes
Mohammad


Douglas Glenn

unread,
Dec 21, 2020, 1:53:44 PM12/21/20
to TiddlyWiki
Mohammad,

Pre-populating the user fields, ect. was a thought of the moment, but I agree with you on pre populating fields. I suggest as an alternative instead of spending the time and energy to build an interface in Refnotes. Just add an enhancement to import .bib files, and provide a short list of links to editors so you don't have to reinvent the wheel. I also included on tutorial site as well so rank beginners such as myself can use to self-educate from an easy to read environment. I wouldn't recommend people to have to dig into the actual documentation. It's overkill and more likely to turn people off when they see it.  I hope this helps! and thank you for taking the time to listen to me.

Tutorial:

Free Online BibTEX editor:   https://truben.no/latex/bibtex/

Free Cross platform editors:  
    https://www.jabref.org  (Apple OS X, Windows, Linux)

Native Linux
Linux KDE gui:  bibTEX (through the package manager for the distro)

Linux Gnome gui:  

Aggregate listings of multiple editors in  a single place   
    10 Best Latex editors for 2021 :   https://beebom.com/best-latex-editors/

Mohammad Rahmani

unread,
Dec 21, 2020, 2:49:25 PM12/21/20
to tiddl...@googlegroups.com
Hi Douglas,

Many thanks for your feedback. I added a ticket to the discussion board: https://github.com/kookma/TW-Refnotes/discussions/8

Best wishes
Mohammad


Douglas Glenn

unread,
Dec 21, 2020, 3:04:21 PM12/21/20
to TiddlyWiki
Mohammad, 

Thank you for the feedback you gave me and the super quick response. 

I appreciate your time very much.
Reply all
Reply to author
Forward
0 new messages