Power Tags
Power tags are an advanced feature which can add extra functions and layout options to your wiki pages (and sometimes research notes). They are entered like regular tags but follow the format key:value
. After adding a power tag, you must refresh the page.
To add tags, look for this box at the bottom of a wiki page or research note:
General power tags
events:foo
displays a listing of research notes tagged with "event" and "foo", and a link to post new notes with those tags in the left sidebar.sidebar:featured
displays "featured" links and images in the sidebar instead of the usual "related content"style:presentation
hides the wiki toolbar (with Edit, Talk, Revisions) for more formal pages, and makes the lead image of wiki pages full-widthstyle:minimal
just hides the wiki toolbar (but it's accessible via a small caret button)style:wide
removes the 800px width limit from wiki pages, and allows them to flow full pagestyle:fancy
is used to style articles from the GrassrootsMappingForumstyle:nobanner
parent:foo
adds a bar that links back to a parent wiki pagewith:username
adds a co-author to your research note with a live link to the user's profile page, however, the note itself will not show up under that user's profile.lang:es
oriso:es
is the way to indicate language in a research note or event. In this example,es
indicates Spanish.
List of power tags useful for chapter pages:
lat:41.023
andlon:-71.023
latitude and longitude. Together with the simple tag "chapter", the combination of these three tags will create a point for your chapter on the Places mapevents:foo
displays a listing of research notes tagged with "event" and "foo", and a link to post new notes with those tags in the left sidebar. Especially useful where foo = the name of your chapter page.list:foo
displays recent posts from a Google Group with the name "foo" and a subscription input boxtabbed:notes
andtabbed:wikis
display a tabbed header which offers tabs with links of related research note and wiki contentnotes:foo
displays 4 recent "popular" research notes tagged "foo" (in grid view, popular means >20 views) at the top of the page, under the tabs if they exist. For example see [Gulf Coast](/wiki/gulf-coast]parent:foo
adds a bar that links back to a parent wiki page, especially useful for places within regions
Inline power tags
You can now use "inline" power tags in the middle of a research note or wiki page. The first one is for generating a list of notes for a given tag, and is used in this format:
[notes:<tagname>]
For example, to list all notes tagged with peru
, you can use:
[notes:peru]
For a more complex example, you can list all questions on the topic of "infragram" using:
[notes:question:infragram]
More advanced uses like activity grids can be found in this post: https://publiclab.org/notes/liz/08-30-2016/check-out-these-activity-grids
Automated power tags, not for manual adding
You might see some of these being generated automatically, like when checking the box for a Research Note to be an "Event" or a "question" or when awarding Barnstars to someone's Research Note. Don't manually add these:
event:rsvp
date:YYYY-MM-DD
rsvp:username
barnstar:barnstarname
question:foo
response:foo
Tag aliasing
This feature is for admins only -- please contact web@publiclab.org with questions.
We're planning a system for aliasing tags, which serves a number of purposes:
A) disambiguation -- we have both spectrometer
and spectrometry
-- we'd prefer spectrometry
.
- When looking at https://publiclab.org/tag/spectrometer, should you see content tagged with
spectrometry
? (I think yes, if they're "parented" to each other mutually.)
B) subcategories -- multispectral-imaging
contains and is broader than infragram
.
- When looking at https://publiclab.org/tag/multispectral-imaging, should you see content tagged with
infragram
? (I think so -- that's a broader category that includes it.) - When looking at https://publiclab.org/tag/infragram, should you see content tagged with
multispectral-imaging
? (I think not -- that's a broader category than you're looking for.)
C) extending functions -- note that this requires wildcard parenting -- we want all posts tagged activity:*
(where * could be anything) to also get features applied to the seeks:replications
tag. But since wildcards are... wild, this functionality is more narrow, and only triggers more specific functions (using the has_tag
feature; see this issue if you're interested in how it works).
- A post tagged
activity:spectrometry
also gets the "replication request zone" which is triggered byseeks:replications
even though it doesn't explicitly have that tag, becauseseeks:replications
tag has the "parent tag" ofactivity:*
(a wildcard). - However, when you see activities at https://publiclab.org/tag/activity:spectrometry, or all activities using https://publiclab.org/tag/activity:*, you don't also get content tagged with
seeks:replications
. - When you go to https://publiclab.org/tag/seeks:replications, you don't also get content tagged with
activity:*
.
Later goals:
Some aliasing features are more complex and not complete yet.
Email subscriptions - when people subscribe to a tag, they should receive emails when content is posted using a tag that has a "parent" of the subscribed-to tag. (Or should it be when content is posted using a tag that is a parent of the subscribed-to tag?) Imagine if the tag infragram
had the parent multispectral-imaging
in each of the above scenarios.
And -- perhaps children should greedily fetch parent tags, but not vice versa -- say, if we say conductivity is a child of open-water but not everything open-water is conductivity... this could be important for "watching" tags or subscribing to them.
And clarification for usage -- though "balloon-mapping" is a type of "aerial-photography", we don't want one to return content tagged with the other...!