Automating posting from TiddlyWiki to Discourse

Community Projects Documentation
#1

Just an aside that may lead some where;

  • See my recent post How to paste the Output of your Tiddlers Here in Discourse
  • Part of people submitting documentation can be a discussion about it. So I show this as and example of taking tiddler content and placing it in Discourse.
  • One idea may be to add to the automation of document changes the posting to a Discourse Thread allowing discussion or suggestions before or after a PR?

The following is a quick but incomplete example of a modified document tiddler WidgetMessage: tm-add-field

WidgetMessage: tm-add-field

The tm-add-field message is handled by the FieldManglerWidget. It adds the specified field with a blank value if the field doesn't already exist.

Name Description
param Name of field to add

The add field message is usually generated with the ButtonWidget, and is handled by the FieldManglerWidget.

copy to clipboard 

<$action-sendmessage $message="tm-add-field" $param="fieldname"/>

That renders as:

Edit documentation in TW and use Github API to create PRs directly?
#2

I don’t think we’re in a position to write custom Discourse code for this.

Encouraging people to post to Discourse for feedback works just as well.

#3

Boris,

Perhaps not automated but my post shows the formatting when copying the html of a tiddler.

This way we can often share the content.

A copy to html button to clipboard could help.

#4

Ciao @TW_Tones I only just looked at your post you refer to.

What is the upshot? Ability to get HTML has been around in TW for yonks. For instance, @Mark_S’ NotoWriterly does it simples.

However I agree that a more push-button add-on set for TW that copies output to Plain Text or HTML would ease social networking for users who like that kind of thing.

BTW, hasn’t @BurningTreeC already made a tool for posting TW-to-Discourse?

A comment
TT

#5

I will look for that of @BurningTreeC. I suppose I am suggesting its on Tiddlywiki.com or made prominent for general users to make use of.

Otherwise this post just lets people know what they can do. For example to illustrate a widget they are talking about, so the reader need not follow a link.

The idea of submitting changes from tiddlywiki.com or a copy of it direct to git hub is also on its way.

If these things are not installed on tiddlywiki, and if they do not demand a reload, they could be installed by a bookmarklet (ie no Javascript tiddlers)

1 Like
#6

Another example perhaps to illustrate and discuss a rewrite

## Documentation Macros

The following macros are used throughout TiddlyWiki's documentation. Their names start with a dot to keep them out of the way of names that a user might try experimenting with.

General

Macro Used for Example
.def the defining instance of a term widget
.em minor emphasis within a sentence not
.place a placeholder for the user to fill in tagname
.strong major emphasis within a tiddler Important!
.word a mention of an ordinary word or phrase "hello world"

Advice

Macro Used for Example
.tip hints and tips
Turn your screen on, otherwise
you won't be able to see much.
.warning warning advice
Make a backup of your file
before you upgrade.

Blocks

Macro Used for
.preamble an introductory sentence that stands apart from the rest of the tiddler

Tiddlers and fields

Macro Used for Example
.tid a tiddler title Example
.tag a tag Example
.field a field name example
.value a field value example value
.op a filter operator backlinks
.var a variable or macro name currentTiddler
.wid a widget name $list
.attr an attribute name filter
.param a macro parameter name text

Links

Macro Used for Example
.link a link containing WikiText an example
.clink a code link <$list>
.dlink a link on a defining instance of a term widget
.dlink-ex an external link on a defining instance of a term Example
.flink a link to a field list
.mlink a link to a macro qualify
.mlink2 a link to a macro, with specified target foo
.olink a link to an operator prefix
.olink2 a link to an operator, with specified target foo
.vlink a link to a variable currentTiddler
.vlink2 a link to a variable, with specified target foo
.wlink a link to a widget $button
.wlink2 a link to a widget, with specified text foo

User interface

Macro Used for Example
.key a key on the keyboard Escape
.keycombo a key combination Ctrl+Enter

Tabs

Macro Used for Example
.sidebar-tab the name of a sidebar tab More
.more-tab the name of a subtab of the More tab Shadows
.info-tab the name of a tiddler info tab Fields
.controlpanel-tab the name of a Control Panel tab Settings
.advancedsearch-tab the name of an Advanced Search tab Filter
.toc-tab name of the tw5.com TOC tab Contents
.example-tab an example tab name Notes

Parameters for .sidebar-tab

Open Open
Recent Recent
Tools Tools
More More

Parameters for .more-tab

All All
Recent Recent
Tags Tags
Missing Missing
Drafts Drafts
Orphans Orphans
Types Types
System System
Shadows Shadows

Parameters for .info-tab

Tools Tools
References Backlinks
Tagging Tagging
List List
Listed Listed
Fields Fields
Advanced Advanced

Parameters for .controlpanel-tab

Info Info
Appearance Appearance
Settings Settings
Saving Saving
Plugins Plugins

Parameters for .advancedsearch-tab

Standard Standard
System System
Shadows Shadows
Filter Filter

Buttons

Macro Used for Example
.button a standard button name and icon new tiddler

Parameters for .button

Tiddler toolbar

clone clone
close close
close-others close others
edit edit
export-tiddler export tiddler
info info
more-tiddler-actions more
new-here new here
new-journal-here 27 new journal here
permalink permalink

Edit-mode toolbar

cancel cancel
delete delete
save ok
#7

Of note the total size was limited so here is the balance

Page toolbar

advanced-search advanced search
close-all close all
control-panel control panel
encryption encryption
export-page export all
full-screen full-screen
home home
import import
language language
more-page-actions more
new-journal 27 new journal
new-tiddler new tiddler
permaview permaview
refresh refresh
save-wiki save changes
storyview storyview
tag-manager tag manager
theme theme