Home      FAQ      Forum      Idea Exchange      Ask a Question      My Stuff      Help   
  
Markup Extensions
We've switched our markup processor to a new, more powerful one. At the moment it is configured to preserve compatibility with old processor (except for line breaks no longer require two spaces at the end of the line), but there are couple of new features available we can enable.

Those new features are best described here:
http://michelf.ca/projects/php-markdown/extra/

In general we have two places markup is in use: "Text - Multiline" columns and E-Mail Alert Actions.

Some features, like Special Attributes and Footnotes are not really useful for TeamDesk, but enabling Fenced Code Blocks, Tables, Definition Lists and Abbreviations might be a nice addition to both columns and alerts.

Moreover, we think it would be safe to enable "Inline HTML" and "Markdown Inside HTML Blocks" in e-mail alerts to allow more flexible message styling.

What do you think?
ID
704
Category
TeamDesk
Author

Kirill Bondar  Staff 
Date Created
12/25/2013 4:02:22 AM
Date Updated
2/7/2014 9:17:03 AM
Status
Implemented
Score
80
Promoted By
ellen ganzevlesDamon Savagemartin oliver
Sam ParishMartin OdendaalNathan Phillips (CW)
Rick CogleyKirill Bondar  Staff 
Comments
Rick Cogley 12/25/2013 4:36:28 AM
Big +1 from me. We have a "Documents" table, in which we have a large Markup text area for writing documentation, wiki-style. Most of the new attributes including inline HTML would be really useful for us.
Rick Cogley 12/25/2013 4:50:19 AM
Right now we have a bunch of docs with inline HTML in a span tag, to get highlighting on text. This broke with the update.

To get tables we have relied upon taking screenshots of an Excel, and referencing that, in our markup text boxes. It would be great to be able to get away from that.

I suppose special attributes might be nice, if you want to really control the way a longer doc would look. I guess we could upload the CSS as a file or resource in SETUP, and reference it.

Fenced code blocks, yes, please. We are using lots of fiddly syntax with spaces and back ticks, to get the current formatting to work.

Abbreviations would be great if you could make one document and put all your abbreviations in it, then reference it. But with longer docs, it might be helpful even if you had to copy paste a master list.

I love the mid-word under bar literals feature. We have struggled with reports that have variables or filenames, because of the escaping that has to be done.


Nathan Phillips (CW) 12/25/2013 11:24:03 AM
Nice! I could use these features in email alerts.
Sam Parish 12/27/2013 12:49:39 PM
We are doing more with Markup text every week.. Good!
Rick Cogley 1/31/2014 8:18:16 AM
Slava, Kirill - how's this going? Any way to get these features enabled?
Kirill Bondar  Staff  2/3/2014 10:02:25 AM
@Rich: It turns out that this change is slightly more complicated that we initially expected as we have to update markup-to-Word rendering code to support new elements, yet it is next in the to-do list.
Rick Cogley 2/3/2014 7:12:01 PM
Ah, of course. I look forward to it, Kirill. Thanks.
Kirill Bondar  Staff  2/4/2014 7:26:56 AM
Following extras are enabled for E-Mail Alert Actions only: Tables, Fenced Code Blocks, Abbreviations, Definition Lists, Inline HTML; Markup inside HTML is on by default, you can turn it off by adding markup="off" attribute to an HTML tag.

Inline HTML is enabled for the following tags:

"a", "b", "blockquote", "code", "dd", "dt", "dl", "del", "font", "em", "h1", "h2", "h3", "h4", "h5", "h6", "hr", "br", "i", "img", "kbd", "li", "ol", "ul", "table", "caption", "thead", "tbody", "tr", "th", "td", "p", "pre", "s", "sub", "sup", "strong", "strike", "style", "u".

All those tags are enabled to use "id", "class", "style" and "title" attributes.
In addition following tag-specific attributes are enabled:

"a": "href", "target";
"img": "src", "width", "height", "alt";
"font": "face", "size", "color";
"table": "border", "cellpadding", "cellspacing";
"tr": "bgcolor";
"th", "td": "bgcolor", "align", "valign", "nowrap"

As soon as we solve rendering problems with markup fields in Documents we'll enable Tables, Fenced Code Blocks, Abbreviations, Definition Lists for Text - Multiline columns as well.


Rick Cogley 2/5/2014 1:57:04 AM
Thank you, Kirill.
Kirill Bondar  Staff  2/7/2014 5:33:42 AM
We've also enabled all extra features but HTML for Text - Multiline columns. To render these features correctly in the Word document we've also changed the way we are exporting markup to Word: there might be subtle styling difference. We are preparing blog post covering the changes.

As a bonus, due that change XHTML - Formulas should be exported to Word correctly.
Kirill Bondar  Staff  2/7/2014 9:17:03 AM
Feedback
 
Back to Search Results