Refnotes plugin

544 views
Skip to first unread message

Mohammad

unread,
Dec 28, 2018, 7:09:21 AM12/28/18
to tiddl...@googlegroups.com
Announcement: A new release
Date: Mar 20th, 2019
  • New bibtex macro for bibliograpy
  • Improved documenattion


Announcement a new  release of Refnotes plugin 

(4th Jan, 2019)
  • Issue for small screen devices fixed
  • Issue for touch screen devices fixed


Announcement a new plugin 

(28th Dec, 2018)

Refnotes plugin    

To download have a look at:
 



Refnotes

Refnotes is a set of macros and stylesheets for creating abbreviation, footnote and reference (citation). It can be used to make tables of footnotes, abbreviations and also bibliography table.

It contains codes and elements for

  1. Create and insert
    1. Abbreviation (abbr macro)
    2. Footnote (fnote macro)
    3. Reference (ref macro)
  2. Creating list (table) of
    1. Abbreviations (glossary table) (showabbrs macro)
    2. Footnotes and endnotes (showfnotes macro)
    3. References (bibliography) using different output style (showrefs macro)

Requirements

The Refnotes requires

  • TW 5.1.18 (and above)
  • The find macro

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



You comments and issue report is highly welcome!


Best regards
Mohammad

Riz

unread,
Dec 28, 2018, 1:22:49 PM12/28/18
to TiddlyWiki
Thank you Mohammad.

It is a very useful work. I am sure many of the heavy users of Tiddlywiki would have considered building such a system. May be few even have primitive alternatives present in their workflow. To have such a unified complement to note taking, without losing out on the aesthetics is definitely going to help.
I suggest you submit it to Dave's list as well as to the community section of documentation.

I will leave you with a pointer, if you plan on further development. The abbreviation macro, as it is, does not expand on mobile browsers. If the source could be manipulated such that if the window size is below certain size, macro returns the expanded form by default, that would ensure that people accessing from smaller screens would not miss anything.

Good job.

Sincerely
Riz

Mohammad

unread,
Dec 28, 2018, 2:10:08 PM12/28/18
to TiddlyWiki
Hello Riz,

 Many thanks for your words and your comments.

I have not tested on mobile, but right now using the BTC TW.app, I see the tooltip on mobile is not working as it works on Desktop.
I will consider this and hopefully I can revise the code to work on small screen of cell phones.

Thank you again.

Cheers
Mohammad

Kalmir

unread,
Dec 29, 2018, 2:15:35 PM12/29/18
to TiddlyWiki
Mohammad, thanks a lot, your plugin is going to be very helpful when using TW for academic work. It definitely makes it into my TW :-)

Mohammad

unread,
Dec 29, 2018, 2:43:47 PM12/29/18
to TiddlyWiki
Hi Kalmir,

 You are most welcome. As I understood and commented by Riz, on touch based system like mobile screen the abbreviation (Html5 tag) and tooltips are not as we expected.

If you use TW on Desktop, then Refnotes could be very helpful. It has been tested using FF 64, Chrome 71, Edge and IE 11. No issue has been reported.

A rather complete documentation and a bunch of examples have been added into the demo page on GitHub.

I appreciate to receive your comments and, issue reports here or on GitHub page.

Have a nice holidays

Cheers
Mohammad 

@TiddlyTweeter

unread,
Dec 29, 2018, 8:34:59 PM12/29/18
to TiddlyWiki
Looks neat! I like it tries to deal with the true richness of referencing.

I need a bit of time to understand it's details and try it. I'll write more later.

Best
Josiah

Kalmir

unread,
Dec 30, 2018, 5:14:01 AM12/30/18
to tiddl...@googlegroups.com
Just as a side-note: as I am not much familiar with GitHub, installation of the plugin wasn't that simple for me, actually. I tried to download the code (tiddler to import) by right-clicking on the name of the file from release page (a page one level above than the one your plugin web links to). But importing this tiddler, download in this way, didn't install the plugin. So I found a workaround by downloading and importing plugin tiddlers not from github, but from the plugin webpage itself (found them through search).

I am probably missing how to do it easily via GitHub. My point is there may be more people like me, perhaps some not even able to find a workaround.

Mohammad

unread,
Dec 30, 2018, 6:56:50 AM12/30/18
to TiddlyWiki
Hello Kalmir,

Sure I will correct the link. But you should be able to clone the project in GitHub or download the file.

As soon as I get back to the desk, I will update the installation section on the webpage.

Thank you again
Mohammad

Mohammad

unread,
Dec 30, 2018, 11:35:29 AM12/30/18
to TiddlyWiki
Hi again Kalmir,
 The installation on demo page corrected. A release was created.

The reason I asked to download from GitHub is to be able to track the number of downloads.

Best
Mohammad

Kalmir

unread,
Dec 30, 2018, 2:14:34 PM12/30/18
to TiddlyWiki
Great! I managed to install the plugin with my workaround but perhaps your changes will now save some trouble for some users.

Anyways, great piece of work, thank you.

Mohammad

unread,
Jan 3, 2019, 6:21:31 PM1/3/19
to TiddlyWiki
Hello Riz,

 I have updated Refnotes to address the issues with touch screen and small screen devices.
It now shows the tooltip as a top full width div element. The abbr also expand its content on touch.

Hope this can be useful.


Cheers
Mohammad

Mohammad

unread,
Jan 3, 2019, 6:24:54 PM1/3/19
to TiddlyWiki
A new release of Refnotes plugin (minor issues fixed) has been announced.

See original post:


--Mohammad

James

unread,
Jan 4, 2019, 8:00:47 PM1/4/19
to TiddlyWiki
Hi Mohammad,

I have installed the Refnotes plugin but the tooltips doesn't work.  Is there any other plugins I need to install so that I can see the pop up tooltips?

TonyM

unread,
Jan 4, 2019, 9:02:18 PM1/4/19
to TiddlyWiki
Mohammad,

I have finally gotten around to taking a deeper look. The Find macro is yours and embedded in the ref notes plugin?, it could be published separately of course, or its equivalent should in my view be available in the empty.html

I wanted to ask if you have ever tried to wikify the result returned from the find macro? And how would you do it?

Regards
Tony

Mohammad

unread,
Jan 4, 2019, 9:02:51 PM1/4/19
to TiddlyWiki
Hi James
Would you please give a try here

https://kookma.github.io/Refnotes/

This is the online demo and doc page.

What browser do you use? Are you using a desktop or tablet or cell phone?


--Mohammad

Mohammad

unread,
Jan 4, 2019, 9:13:57 PM1/4/19
to TiddlyWiki
Hi Tony,
The find macro is mine and not available in empty.html. Of course Thomas Elmiger has already published an equivalent extract macro. Find uses features of newer TW release. Also it is very compact and easy to understand. It uses an output macro as input parameter, which gives it alot of power to customize the output.

I have used the wikify widget several times in the code, look at showrefs.

Still there are rooms for improvement. A small issue is when showrefs gets a tiddller with space in title, it should be passed using [[]], not "". This happen where <<ref [[tid with space]]>> is used.

Cheers
Mohammad

oleghbond

unread,
Jan 5, 2019, 6:47:46 AM1/5/19
to TiddlyWiki
Thanks, Mohammad,

nice stuff.

пʼятниця, 28 грудня 2018 р. 14:09:21 UTC+2 користувач Mohammad написав:

TonyM

unread,
Jan 5, 2019, 5:48:22 PM1/5/19
to TiddlyWiki
Mohammad,

I am not sure you need to fix this case


"where <<ref [[tid with space]]>> is used"

Because it should be 'illegal'

The correct form is

where <<ref "[[tid with space]]">>

And in many cases

<<ref "tid with space">>
would be sufficent, or should be.

Regards
Tony

Mohammad

unread,
Mar 20, 2019, 3:29:31 PM3/20/19
to TiddlyWiki
Dear all,
 I am pleased to announce a new release of Refnotes. This release is published in collaboration with Mark S.

The new release includes
  • A new macro to create table of references
  • An extensive documentation
  • Demos and helps
  • Improved find macro
I appreciate your feedback.

Best regards
Mohammad



--Mohammad

Demo and documentation: https://kookma.github.io/Refnotes/

Olegh Bondarenko

unread,
Mar 20, 2019, 4:29:56 PM3/20/19
to tiddl...@googlegroups.com
Thanks, Mohammad,
I'll definitely give my feedback shortly.
Olegh Bondarenko
http://bit.ly/OleghBond





ср, 20 бер. 2019 о 21:29 Mohammad <mohammad...@gmail.com> пише:
--
You received this message because you are subscribed to a topic in the Google Groups "TiddlyWiki" group.
To unsubscribe from this topic, visit https://groups.google.com/d/topic/tiddlywiki/HLru0XFEnyI/unsubscribe.
To unsubscribe from this group and all its topics, send an email to tiddlywiki+...@googlegroups.com.
To post to this group, send email to tiddl...@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit https://groups.google.com/d/msgid/tiddlywiki/2fa9d117-c76c-4b7c-b723-90d5e6fb4592%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Jon

unread,
Oct 16, 2019, 3:03:09 AM10/16/19
to TiddlyWiki
Hi Mohammad, I've just started using this and really appreciate it.
Many thanks
Jon

On Wednesday, 20 March 2019 20:29:56 UTC, oleghbond wrote:
Thanks, Mohammad,
I'll definitely give my feedback shortly.
Olegh Bondarenko
http://bit.ly/OleghBond





ср, 20 бер. 2019 о 21:29 Mohammad <mohamma...@gmail.com> пише:
Dear all,
 I am pleased to announce a new release of Refnotes. This release is published in collaboration with Mark S.

The new release includes
  • A new macro to create table of references
  • An extensive documentation
  • Demos and helps
  • Improved find macro
I appreciate your feedback.

Best regards
Mohammad



--Mohammad

Demo and documentation: https://kookma.github.io/Refnotes/

--
You received this message because you are subscribed to a topic in the Google Groups "TiddlyWiki" group.
To unsubscribe from this topic, visit https://groups.google.com/d/topic/tiddlywiki/HLru0XFEnyI/unsubscribe.
To unsubscribe from this group and all its topics, send an email to tiddl...@googlegroups.com.

Mohammad

unread,
Oct 16, 2019, 7:40:41 AM10/16/19
to TiddlyWiki
Thank you for your feedback Jon!

--Mohammad

@TiddlyTweeter

unread,
Oct 17, 2019, 2:33:36 PM10/17/19
to TiddlyWiki
Ciao Mohammad

I FORGOT this existed!

You made so many good resources.

Maybe sometime you'd like to make a post that lists them ALL?

Best wishes
TT

Mohammad

unread,
Oct 17, 2019, 3:08:51 PM10/17/19
to TiddlyWiki
Thanks Josiah!
Refnotes is a plugin developed as a joint work with Mark S.

Sure, I will post them as a single list. 

Also Jed has sent link shows how to create a plugin library, I hope I can publish a plugin library in near future.

--Mohammad

@TiddlyTweeter

unread,
Oct 17, 2019, 3:19:41 PM10/17/19
to TiddlyWiki
Mark S. is humble. And he is not a "polished" endgame man. He is the bloke who likes and understands the engine of the car and gets it working.

He is, IMO, the AA of TW ... https://www.youtube.com/watch?v=I88L-CCygtg 

TT
Reply all
Reply to author
Forward
0 new messages