[Introducing] TiddlyJam - new Plugin, CMS and static website generator

576 views
Skip to first unread message

Adithya B

unread,
Mar 14, 2021, 1:17:56 PM3/14/21
to TiddlyWiki
Hi everyone!

I have been working on a static website generator/CMS plugin for TiddlyWiki for my personal use for the past six months or so. Finally, I feel I am ready to share it!
Cheers!
Adithya

Mohammad Rahmani

unread,
Mar 14, 2021, 2:06:31 PM3/14/21
to tiddl...@googlegroups.com
Hi Adithya,


 Many thanks for sharing this! The link to https://tiddlyjam.com does not work
 Would you please check?





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/489f0344-e191-4c29-9167-670e382048c4n%40googlegroups.com.

Mat

unread,
Mar 14, 2021, 2:24:05 PM3/14/21
to TiddlyWiki
Like Mohammad says, the https://tiddlyjam.com and /tiddly don't work.
Really curious about it!
<:-)

Adithya B

unread,
Mar 14, 2021, 5:41:23 PM3/14/21
to TiddlyWiki
Hi Mat, Mohammad,

Its up now. Thanks for the heads-up.

Cheers,
Adithya

clutterstack

unread,
Mar 14, 2021, 7:38:09 PM3/14/21
to TiddlyWiki
Hi Adithya,

TiddlyJam looks very nice! I think it's a great use for TiddlyWiki.

Best wishes,
Chris

Adithya B

unread,
Mar 14, 2021, 8:18:43 PM3/14/21
to TiddlyWiki
Its very bare bones for now. I hope to add more features to make it a full fledged CMS :)

Mohammad Rahmani

unread,
Mar 15, 2021, 12:18:43 AM3/15/21
to tiddl...@googlegroups.com
Hi Adithya,
 Very nice job and I see many use cases for Tiddlyjam!

Some minor comments


I. You may edit the .info (e.g. tiddlywiki.info which resides in root of any TW) file of selected Wiki as below

"tiddlyjam":[
"--rendertiddlers",
"[all[tiddlers+shadows]tag[$:/plugins/adithyab/tiddlyjam/live]]",
"$:/plugins/adithyab/tiddlyjam/renderer/base",
".",
"text/plain",
"--render",
"[all[tiddlers+shadows][$:/plugins/adithyab/tiddlyjam/renderer/sitemap]]",
"sitemap.xml",
"text/plain"

]


And simply for command like

tiddlywiki --build tiddlyjam

I did not understand the "." in the command!!


II. Adding new page
It is good to add short description tell user how add a new tiddler (page) to be included in website/blog generated

III. Home button
For my test on local machine, clicking on home button opens the root folder, I did not test online to see if it open the index.html or not




Regarding the name  (ignore if irrelevant)
As there is a dispute on using Tiddly ( Myself do not use Tiddly for plugins anymore) I may suggest other names
- Agra static site generator
- Pune static site generator
- or what other name you like..


Best wishes
Mohammad


On Sun, Mar 14, 2021 at 8:47 PM Adithya B <bmad...@gmail.com> wrote:
--

Mohammad Rahmani

unread,
Mar 15, 2021, 12:20:33 AM3/15/21
to tiddl...@googlegroups.com
Adithya,

My sample tiddlywiki.info file looks like below

{
    "description": "Basic client-server edition",
    "plugins": [
        "tiddlywiki/tiddlyweb",
        "tiddlywiki/filesystem",
        "tiddlywiki/highlight"
    ],
    "themes": [
        "tiddlywiki/vanilla",
        "tiddlywiki/snowwhite"
    ],
    "build": {
        "index": [
            "--rendertiddler",
            "$:/plugins/tiddlywiki/tiddlyweb/save/offline",
            "index.html",
            "text/plain"
        ],
        "static": [
            "--rendertiddler",
            "$:/core/templates/static.template.html",
            "static.html",
            "text/plain",
            "--rendertiddler",
            "$:/core/templates/alltiddlers.template.html",
            "alltiddlers.html",
            "text/plain",
            "--rendertiddlers",
            "[!is[system]]",
            "$:/core/templates/static.tiddler.html",
            "static",
            "text/plain",
            "--rendertiddler",
            "$:/core/templates/static.template.css",
            "static/static.css",
            "text/plain"
        ],

"tiddlyjam":[
"--rendertiddlers",
"[all[tiddlers+shadows]tag[$:/plugins/adithyab/tiddlyjam/live]]",
"$:/plugins/adithyab/tiddlyjam/renderer/base",
".",
"text/plain",
"--render",
"[all[tiddlers+shadows][$:/plugins/adithyab/tiddlyjam/renderer/sitemap]]",
"sitemap.xml",
"text/plain"

]
    }
}



Best wishes
Mohammad

Mohammad Rahmani

unread,
Mar 15, 2021, 12:34:15 AM3/15/21
to tiddl...@googlegroups.com
More comments

The css is fetched as below

- Consider option for offline work (optional inclusion of a styles.css )
- Consider inclusion of some extra css (for example if I have a custom card or button) I know the best practice is to stick with bulma
  if it is the main css framework here!




Best wishes
Mohammad


On Sun, Mar 14, 2021 at 8:47 PM Adithya B <bmad...@gmail.com> wrote:
--

Mark S.

unread,
Mar 15, 2021, 10:28:54 AM3/15/21
to TiddlyWiki
Added to the TiddlyWiki Toolmap under "Web hosting and publishing, using TiddlyWiki online"

Jeremy Ruston

unread,
Mar 15, 2021, 11:19:48 AM3/15/21
to TiddlyWiki Group
Hi Adithya,

Congratulations, TiddlyJam is a terrific piece of work, and I enjoyed looking at your other work.

I am working on this area as part of the work that I’m doing with Fission, and will publish a PR in the next day or two with a new framework for publishing static sites. May I borrow your sitemap.xml template for inclusion?

I hadn’t seen your CodeMirror syntax highlighting module before:


Would you consider contributing it to the core?

Best wishes

Jeremy

Adithya B

unread,
Mar 15, 2021, 11:58:32 AM3/15/21
to TiddlyWiki
Hi Mohammed, 

Thanks for your suggestions and code snippets! I have added some to the issue tracker on the repo and will close them in the coming days.
About the css thing: I didnt want to work on the css for the first version so I gave it over to a CDN. I will add more functionality as you suggested - I am planning to make different themes and each can have its own css which will be exported alongside the build process.

Hi Mark, Thanks!

Hi Jeremy,
Please feel free to use the sitemap.xml.
About the TW5-codemirror-plus module - I would love to contribute to the core. It is in a functional stage (I have been using it personally), but there is still a lot of work pending on that repo. I intended to start on that once the TiddlyJam project comes upto a stage. How should that work?

Regards,
Adithya


Adithya B

unread,
Mar 15, 2021, 12:05:21 PM3/15/21
to TiddlyWiki
Also, looking forward to the new framework for publishing static sites!

Soren Bjornstad

unread,
Mar 15, 2021, 3:25:07 PM3/15/21
to TiddlyWiki
Adithya,

Just want to say thanks for the CodeMirror plugin -- even as it stands, this is awesome!

Adithya B

unread,
Mar 15, 2021, 3:47:40 PM3/15/21
to TiddlyWiki

Thanks Soren! I like it too :)

I really hope to add some more features to it soon. If you have any specific feedback or notice any bugs, please do let me know either here or on the repo itself.

Florian Felix

unread,
Mar 16, 2021, 12:49:02 PM3/16/21
to TiddlyWiki
This all looks very lovely :) especially your own website.
I am also looking for a "digital gardening" tool, though i'm not capable of coding myself.
This and jeremys announcement are making me hopeful for finally being able to settling for tiddlywiki - i was just going to start to look into org-roam, although i have found so many cool features in TW.
You are not planning on adding things like a toggleable-sidebar, a graph - visualization, and a search, though, are you (:

Adithya B

unread,
Mar 16, 2021, 12:50:44 PM3/16/21
to TiddlyWiki
Thanks for your comment!

To answer your question about the plans for this project:
Toggleable sidebar and search - yes
Graph-visualization - probably not (its possible though)

Florian Felix

unread,
Mar 16, 2021, 1:15:51 PM3/16/21
to TiddlyWiki
cool! would love graphing, i was first starting with this jekyll template (the map is on the bottom of the side): https://digital-garden-jekyll-template.netlify.app/cats  --- i think there could be possibilities using the graphviz and vis.js libraries that are available as plugins. I should maybe make an own post for that.

Adithya B

unread,
Mar 16, 2021, 5:24:57 PM3/16/21
to TiddlyWiki
Looks like fun!

Florian Felix

unread,
Mar 25, 2021, 3:27:16 PM3/25/21
to TiddlyWiki
So, I have been trying it out.

I really like the website you created for yourself, but its not really clear how you managed that :D
For example where can i change the css? could i just use an existing TW theme that I don't use for the non-static TW and set it up as a template? that would be quite cool bc we would instantly have some cool templates :) Or use the CSS packages for TW that exist (also the icon packs - feather is quite cool)
Then, what are categories for - how do i use them? How do i, in general include tiddlers that are not  pages or blogs like you did?
by the way, here is another, older try at what you're doing - i thought the idea of creating a framework was worthwile, but on the other hand, it uses so many tags...  https://github.com/welford/twstaticblog
 i don't know if it helps but i discovered an easy toggleable sidebar in a jekyll theme when i was trying to work with that which works with a minimum of javascript for the button, i could show you that one - I used to copy that over to over themes, which was pretty easy. I don't even know if that's possible to include though ^^

Adithya B

unread,
Apr 17, 2021, 5:55:24 PM4/17/21
to TiddlyWiki
Hi Flohit,

I have added some notes on how to get started/customize your website here: https://tiddlyjam.com/
Could you check it out and let me know if that helps you?

On categories: I am still getting around to writing support for them into the system. Will update that in a few weeks.

Adithya

Adithya B

unread,
Apr 17, 2021, 10:15:18 PM4/17/21
to TiddlyWiki
@Mohammed,

I have added support for custom css and some additional stuff in the latest release :)

Mohammad Rahmani

unread,
Apr 18, 2021, 1:14:39 AM4/18/21
to tiddl...@googlegroups.com
Hi Adithya,
 Many thanks for the new update! I will go through and will send you my comments if any!



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.
Reply all
Reply to author
Forward
0 new messages