What are tagtog blocks?
As part of the flavored Markdown used in tagtog, you can create blocks with custom styles/layout. As we all know, annotating data can be a tedious task, and a more attractive content can be key to keep your team engaged.
How to use tagtog blocks?
You can add blocks to your content in two ways:
Import to your project a .md
(Markdown) file with one or more tagtog blocks. You can use the API or the GUI.
Copy or write the blocks directly in the +Content menu and set the format as Markdown in the advanced options.
tagtog blocks are Markdown code blocks. For example, you can add a textbox code block as follows:
```textbox
Hello, I'm a textbox block.
```
Block types
Text box
Code: textbox
This block draws a circled box around the content.
Example:
```textbox
In the U.S. federal health care system (including the VA, the Indian Health Service, and NIH) ambulatory care pharmacists are given full independent prescribing authority. In some states such North Carolina and New Mexico these pharmacist clinicians are given collaborative prescriptive and diagnostic authority. In 2011 the board of Pharmaceutical Specialties approved ambulatory care pharmacy practice as a separate board certification.
The official designation for pharmacists who pass the ambulatory care pharmacy specialty certification exam will be Board Certified Ambulatory Care Pharmacist and these pharmacists will carry the initials BCACP.
```
Chatbot
If you combine this layout with the tagtog annotation capabilities, you could perform chatbot annotation tasks such as:
Entity annotation
Intent classification
Create relations between entities
Attach attributes to entities
Context classification
Overlapping annotations (e.g. entity within intent)
Bot
Code: bot
Block for the chatbot interaction. human for the human interaction
Human
Code: human
Block for the human interaction.
Example:
```human
Hi, how are you today?
```
```bot
I'm good. How are you? Do you have a favorite food? Mine is lobster!
```
```human
Doing well, my favorite food is cake. I just bought one because I got promoted at work!
```
```bot
Congratulations on the promotion! What kind of work do you do? I work in software.
```
```human
Thanks so much! I just want to make my parents proud! I'm an engineer.
```
```bot
I'm sure they will be very proud of you. What type of engineering do you work in?
```
```human
I'm an environmental engineer. What is it like to work in software?
```
```bot
It can be a lot of work, but it is very rewarding. Do you enjoy your job?
```
```human
I love it! it's very important to protect the environment.
```
```bot
That's great! Do you have any hobbies? I like to play tennis in my spare time.
```
```human
I'm not very coordinated so I don't play sports… I do like to play the guitar, though!
```
```bot
That's awesome! I've always wanted to learn how to play an instrument. What kind of music do you play?
```
```human
Mostly alternative rock!
```
```bot
That's cool! I like alternative rock as well. What are some of your favorite bands?
```
```human
I like Modest Mouse and the Smashing Pumpkins.
```
Question/Answering
Perfect for question answering datasets.
Question
Code: question
Block for questions.
Answer
Code: answer
Block for answer.
Example:
```textbox
In the U.S. federal health care system (including the VA, the Indian Health Service, and NIH) ambulatory care pharmacists are given full independent prescribing authority. In some states such North Carolina and New Mexico these pharmacist clinicians are given collaborative prescriptive and diagnostic authority. In 2011 the board of Pharmaceutical Specialties approved ambulatory care pharmacy practice as a separate board certification.
The official designation for pharmacists who pass the ambulatory care pharmacy specialty certification exam will be Board Certified Ambulatory Care Pharmacist and these pharmacists will carry the initials BCACP.
```
```question
Q1: What type of authority are ambulatory care pharmacists given in the U.S. federal health care system?
```
```answer
A1: full independent prescribing authority
```
```question
Q2: In what states are pharmacist clinicians given prescriptive and diagnostic authority?
```
```answer
A2: North Carolina and New Mexico
```
```question
Q3: When was ambulatory care pharmacy approved as its own certification?
```
```answer
A3: 2011
```
Tweets
Useful to annotate tweets (please notice that we are not using iFrames to load original tweets from Twitter).
Code: tweet
Block for tweets.
Example:
```tweet
The NHS has published its phase 3 implementation plan in response to the Covid-19 pandemic, including patient-initiated follow ups, the addressing of NHS inequalities and mental health planning.
```
```tweet
The economic impact of COVID19 on the hotel industry is the worst we have ever faced. The hotel industry is expected to lose more than fifty percent of its total revenue in 2020.
```
```tweet
The World Bank Group's FY20 financial statements are out, highlighting the strength of the World Bank Group's financial position, the strong demand for financing including due to COVID19, and the continued backing from shareholders and capital markets.
```
Check the align add-ons for more ideas.
Tasks
Specially at the beginning of an annotation project, it is important to guide the annotator through the whole annotation flow. Usually, a set of guidelines are put together, annotators read through them and they try to label some documents following these rules. Why not to combine theory and practice?
Code: task
Block to define a task for the annotators.
Example:
## Interactive guidelines
Welcome to the interactive guidelines for our medical annotation project.
#### Basic rules:
* The annotator must select the concept codes that better cover the meaning of the clinical concept.
* The annotator must select the fewest number of codes that, together, better covers the meaning of the clinical concept.
* If there is a doubt, don't annotate.
#### Example
```textbox
Complicated fracture of third rib
```
This text could be annotated with the following codes:
1. |255302009| Complicated.
2. |706922007| Complicated fracture of bone.
3. |125605004| Fracture of bone. If annotators are more literal this code could be full coverage. However, other could see the next code as more appropriate and also use the score "inferred coverage".
4. |20274005| Fracture of one rib.
5. |25888004| Bone structure of third rib (body structure).
```task
Explore the different combinations below, click on each annotated entity and see which codes were assigned to it.
```
1,3,5
```textbox
Complicated fracture of third rib
```
2,5
```textbox
Complicated fracture of third rib
```
This would be the best annotation group, because it has a fully coverage and it also has a fewer number of codes
#### Your task
```task
Now it is your turn! Annotate this sentence to fully cover its content.
```
```textbox
other complications of unspecified head injuries
```
Meta information
Sometimes you need to add meta information to other blocks or parts of your document. This contextual information might be important for the annotation task. For example: timestamps, specific ids, etc. or any other piece of information associated to the block.
Meta blocks are not explicitly linked to other blocks, they are stand alone blocks. Therefore, meta blocks won’t auto align with the blocks they refer to.
This block is not annotatable, and users cannot create any manual annotations.
Code: meta
Block to define meta information.
Example:
```meta left
12/11/2020 14:44:30
```
```human
Good morning. I cannot login to my account. I see a connection error. Is your site down?
```
```meta right
12/11/2020 14:44:35
```
```bot
Thank you for your question. According to our status records, our site is now up and running. Can you please check again?
```
Miscellaneous
Quotes
Layout to display quotes.
Code: quote
Block to define quotes.
Example:
```quote
It is easy to hate and it is difficult to love. This is how the whole scheme of things works. All good things are difficult to achieve, and bad things are very easy to get.
Confucius
```
Lyrics
Layout to display lyrics.
Code: lyrics
Block to define lyrics.
Example:
```lyrics
[Verse 1]
Now I've heard there was a secret chord
That David played, and it pleased the Lord
But you don't really care for music, do ya?
It goes like this, the fourth, the fifth
The minor fall, the major lift
The baffled king composing "Hallelujah"
[Chorus]
Hallelujah, Hallelujah
Hallelujah, Hallelujah
[Verse 2]
Your faith was strong but you needed proof
You saw her bathing on the roof
Her beauty and the moonlight overthrew ya
She tied you to a kitchen chair
She broke your throne, and she cut your hair
And from your lips she drew the Hallelujah
[Chorus]
Hallelujah, Hallelujah
Hallelujah, Hallelujah
```
Poems
Layout to display poems.
Code: poem
Block to define a poem.
Example:
```poem
Caminante, son tus huellas
el camino y nada más;
Caminante, no hay camino,
se hace camino al andar.
Al andar se hace el camino,
y al volver la vista atrás
se ve la senda que nunca
se ha de volver a pisar.
Caminante no hay camino
sino estelas en la mar.
- Antonio Machado -
```
Add-ons
Use them to modify blocks. The add-on codes come after the block code. For example: tweet attention
, tweet
being the name of the block, and attention
the name of the add-on.
Attention
This add-on marks a block with a warning to indicate the annotator to pay special attention. For example, to illustrate that this block contains critical information or it is a source of annotation conflicts.
Code: attention
Example:
```bot
Hello, how can I help you?
```
```human attention
I want to report a theft of my account not foreseen 2 days ago, I doubt very much to recover it. However, if it is possible to suspend it, it would be definitely better.
```
```bot
Please let me know your username
```
Not annotatable
This add-on marks a block as not annotatable. This is useful if you don't want annotators to annotate specific parts of your document (e.g. tasks or information for annotators). Manual annotation is not possible for blocks with this add-on.
Code: no-annotatable
Example:
```task no-annotatable
Please annotate the law provisions
```
```textbox
The obligation to comply with European legislation derives ultimately from membership of the European Union. However, European Directives may be transposed into domestic law in different ways. This is well illustrated by the European Directive on Unfair Terms in Consumer Contracts (93/13 EEC). The first attempt to implement the Directive in domestic law showed a distinct lack of imagination, using the ‘copy out’ technique. The provisions of the Directive were simply repeated, mostly verbatim, in a statutory instrument: the Unfair Terms in Consumer Contracts Regulations 1994 (SI 1994/ 3159). The ‘copy out’ approach creates many problems as there is no attempt to integrate the measure with the existing domestic law on the subject. These issues of integration were not addressed when the 1994 Regulations were replaced by a new statutory instrument with the same name but a different date in 1999 (SI 1999/2083).
```
Layout
This collection of add-ons are useful to align your blocks. For example, to align a block to the left/right or to create a multi-columns layout.
Align blocks
Use this add-on to align a block to the left/right.
Codes: left
/ right
Example:
```tweet left
The NHS has published its phase 3 implementation plan in response to the Covid-19 pandemic, including patient-initiated follow ups, the addressing of NHS inequalities and mental health planning.
```
```textbox right
Where can I find an update?
```
```textbox right
Well done!
```
```tweet left
The economic impact of COVID19 on the hotel industry is the worst we have ever faced. The hotel industry is expected to lose more than fifty percent of its total revenue in 2020.
```
```textbox right
This is the end
```
```textbox right
We need support!!
```
```textbox right
It is not only affecting the hotel industry. Look to the restaurants.
```
Multi-column
tagtog blocks supports a grid of 12 columns. Use these add-ons to create a multi-column layout. You can create horizontal groups of columns forming rows. Currently, the add-ons for grid columns are:
Codes: col-*
col-6
: for two-column layout. Each block takes up 6 grid columns. 2 blocks will require the whole 12 (6*2) grid columns.
col-4
: for three-column layout. Each block takes up 4 grid columns. 3 blocks will require the whole 12 (4*3) grid columns.
col-3
: for four-column layout. Each block takes up 3 grid columns. 4 blocks will require the whole 12 (3*4) grid columns.
Example:
```task col-6
当时管原惠庆长老怀着对祖庭的崇高敬意,从寺中摘了一把枣子带回日本,经过精心培育,长成了一棵枣树。(常书鸿, 李承仙, 《五台名刹画沧桑》)
```
```textbox col-6
Then Master Sugehara had a deep respect for Zuting, picked a handful of dates from the Monastery, took back to Japan, after careful cultivation, grew into a big date tree.
```
```task col-6
我买了六只钢笔,一共三十元,拿回家一看,都是用过了的。
```
```textbox col-6 attention
I bought six pens which cost me thirty yuan. When I took them home, I found they were second-hand.
```
Example:
```task col-3
我买了六只钢笔,一共三十元,拿回家一看,都是用过了的。
```
```textbox col-3
wo mai le liu-zhi gang-bi, yi-gong san-shi-yuan, na hui-jia yi-kan, dou-shi yong guo de le.
```
```textbox col-3
I bought six pens, altogether thirty yuan, took home and had a look, all used.
```
```textbox col-3
I bought six pens which cost me thirty yuan. When I took them home, I found they were second-hand.
```
Example:
```question col-6
What type of authority are ambulatory care pharmacists given in the U.S. federal health care system?
```
```answer col-6
Full independent prescribing authority
```
```question col-6
In what states are pharmacist clinicians given prescriptive and diagnostic authority?
```
```answer col-6
North Carolina and New Mexico
```
Align text within blocks
Using this add-on you can align the text within your blocks to left/center/right.
Codes: txtleft
/ txtcenter
/ txtright
Example:
```question col-6
What type of authority are ambulatory care pharmacists given in the U.S. federal health care system?
```
```answer col-6 txtright
Full independent prescribing authority
```
```question col-6
In what states are pharmacist clinicians given prescriptive and diagnostic authority?
```
```answer col-6 txtright
North Carolina and New Mexico
```
Colors
Background color
Using these add-ons you can set/overwrite the background color of a block. Currently, there is a set of predefined colors.
Available codes:
Black: colblack
Red: colred
Green: colgreen
Yellow: colyellow
Blue: colblue
White: colwhite
Text color
Using these add-ons you can set/overwrite the color of the text in a block. The default color is black. Currently, there is a set of predefined colors.
Available codes:
Red: txtred
Green: txtgreen
White: txtwhite
Example: dark mode for fake news
```textbox colblack txtwhite attention
The law would instantly transform all martial arts instructors into criminal felons. This includes instructors who teach kickboxing, BJJ, Krav Maga, boxing and even Capoeira.
It would also criminalize all firearms training classes, including concealed carry classes. It would even criminalize a father teaching his own son how to use a hunting rifle.
Specifically, the law says that a person “is guilty of unlawful paramilitary activity” (a class 5 felony) if that person:
“Assembles with one or more persons for the purpose of training with, practicing with, or being instructed in the use of any firearm, explosive, or incendiary device, or technique capable of causing injury or death to persons…”
The phrase “technique capable of causing injury or death to persons” covers all forms of martial arts and self-defense training, including Krav Maga, BJJ, boxing and other contact martial arts such as Tae Kwon Do or Tai Chi.
Under the proposed law, all forms of self-defense training, including hand-to-hand martial arts training, would be considered “paramilitary activity,” even if the training consists of private classes involving just one instructor and one student. That’s because every form of martial arts training imparts skills which could be used to cause injury to other persons.
In fact, according to the language of the law, just “one” person learning such arts is a felony crime, which means that watching a DVD on Krav Maga would be a felony crime.
```
Fonts
Use these add-ons to customize the font of your block.
Font family
Set/overwrite the font family of a block. Currently, there is one predefined font.
Available codes:
Courier (typewriter/machine): txtmachine
. Example: This is a piece of meta information.
Combining blocks
You can combine tagtog blocks and also combine it with other markdown content.
Example:
## Fake news detection: identifying fake news
1. Is the story unbelievable?
If it’s so incredible that you cannot believe it, you shouldn’t. Alternatively, if is confirms your worst nightmares, you should research it deeper to find supporting or contradictory evidence.
2. Does the story match the headline?
This is an example of clickbait used to pass biased or fake news to unsuspecting readers.
3. What is the timing of the story?
If the article is describing things that will happen, you should be skeptical. You should also double-check that this isn’t an old story. Many sites take stories or pictures from a few years ago and revamp them to fit in with a headline from a current date.
4. Is the story attacking a generic enemy?
Good reporting will not make generalizations and will be specific about who they are criticizing. Be skeptical for vague references, such as the left or Washington.
5. Is there only one incredible fact?
If the story tries to prove or disprove something based on only one encompassing fact, treat it as a warning sign. Look for supporting evidence and links to reputable news outlets.
6. Who is accountable for this information?
All media is vulnerable to mistaken facts and news. However, reputable news sources take accountability for their stories. Biased and fake news outlets often do not take the same steps towards accountability, even going as far as giving fake contact information.
## Tasks
### Tweet annotation
```task
Review the predictions from these two models. Leave only those annotations that represent a false statement.
```
```tweet col-6
We at Snapchat are now legally authorized to give photos and other evidence associated with an open court case if requested by legal authorities. If you would wish to opt. out of this option tag #teamsnapchat on your snap story so that we know who wish to be left out of our option panel. Deadline is September 5th. Happy Snapping.
- Snapchat team
```
```tweet col-6
We at Snapchat are now legally authorized to give photos and other evidence associated with an open court case if requested by legal authorities. If you would wish to opt. out of this option tag #teamsnapchat on your snap story so that we know who wish to be left out of our option panel. Deadline is September 5th. Happy Snapping.
- Snapchat team
```
### Image classification in news
```task
Does this image represent this news? Please set the document label "isImageTrue" to "Yes", "Not sure" or "No"
```
```textbox col-6
Last Tuesday people from Madrid left their cities due to the imminent declaration of state of emergency. The Spanish government plans to impose a 15-day state of emergency in the region of Madrid on Friday, a week after a court struck down the previous measures aimed to curb the spread of coronavirus.
October 12, 2020, Madrid
```
![This is an image](https://mypictures/traffic-jam.jpg)
Caveats
tagtog blocks cannot be nested within each other. For example, you cannot create a task
block inside a textbox
block.
While you can combine any tagtog block or add-ons together (e.g. task
+ question left warning
+ textbox right
), be aware that some of these have a predefined style that might conflict visually with other blocks.
Suggestions
Do you have any other suggestions, feedback or requests? Write us at support@tagtog.com