You are viewing a plain text version of this content. The canonical link for it is here.

Posted to dev@allura.apache.org by Dave Brondsema <br...@users.sf.net> on 2013/10/31 21:41:44 UTC

[allura:tickets] #6822 Option to bypass or escape markdown



---

** [tickets:#6822] Option to bypass or escape markdown**

**Status:** open
**Created:** Thu Oct 31, 2013 08:41 PM UTC by Dave Brondsema
**Last Updated:** Thu Oct 31, 2013 08:41 PM UTC
**Owner:** nobody

All textareas take markdown input, but if you don't realize that and just type or paste something (e.g. code sample, log file) then certain chars may convert into markdown syntax and not render as actually intended.

A checkbox near preview & formatting help buttons could be added.  (Maybe expand to a full toolbar to help with syntax some day).  Changing the data storage for every artifact and the render calls for every artifact is a lot of work and makes the whole system a bit more complex.  If we can use markdown syntax to escape the whole content of the entry, that could work out pretty well I think.

Requested via [forge:feature-requests:#134] and [forge:site-support:#3470]


---

Sent from sourceforge.net because allura-dev@incubator.apache.org is subscribed to https://sourceforge.net/p/allura/tickets/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/allura/admin/tickets/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.

[allura:tickets] #6822 Option to bypass or escape markdown

Posted by Dave Brondsema <br...@users.sf.net>.

- **Milestone**: forge-jan-24 --> limbo



---

** [tickets:#6822] Option to bypass or escape markdown**

**Status:** open
**Created:** Thu Oct 31, 2013 08:41 PM UTC by Dave Brondsema
**Last Updated:** Fri Jan 10, 2014 08:33 PM UTC
**Owner:** nobody

All textareas take markdown input, but if you don't realize that and just type or paste something (e.g. code sample, log file) then certain chars may convert into markdown syntax and not render as actually intended.

A checkbox near preview & formatting help buttons could be added.  (Maybe expand to a full toolbar to help with syntax some day).  Changing the data storage for every artifact and the render calls for every artifact is a lot of work and makes the whole system a bit more complex.  If we can use markdown syntax to escape the whole content of the entry, that could work out pretty well I think.

Requested via [forge:feature-requests:#134] and [forge:site-support:#3470]


---

Sent from sourceforge.net because allura-dev@incubator.apache.org is subscribed to https://sourceforge.net/p/allura/tickets/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/allura/admin/tickets/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.

[allura:tickets] #6822 Option to bypass or escape markdown

Posted by Dave Brondsema <br...@users.sf.net>.

If it's a "paste code snippet" button that escapes the block of text, I think that'd work out okay. Better than escaping the whole thing with `~~~~` fences which would show up in a few places (like plain text notifications). And then we can add more buttons to add more formatting help too, besides just code blocks.

Other different types of solutions might be: requiring preview before post, so issues are noticed. Or having a 'view original text' button so viewers can see the original text as it was entered (this would be useful too for other cases of viewing "source markdown").

---

** [tickets:#6822] Option to bypass or escape markdown**

**Status:** open
**Created:** Thu Oct 31, 2013 08:41 PM UTC by Dave Brondsema
**Last Updated:** Thu Oct 31, 2013 08:43 PM UTC
**Owner:** nobody

All textareas take markdown input, but if you don't realize that and just type or paste something (e.g. code sample, log file) then certain chars may convert into markdown syntax and not render as actually intended.

A checkbox near preview & formatting help buttons could be added. (Maybe expand to a full toolbar to help with syntax some day). Changing the data storage for every artifact and the render calls for every artifact is a lot of work and makes the whole system a bit more complex. If we can use markdown syntax to escape the whole content of the entry, that could work out pretty well I think.

Requested via [forge:feature-requests:#134] and [forge:site-support:#3470]

---

Sent from sourceforge.net because allura-dev@incubator.apache.org is subscribed to https://sourceforge.net/p/allura/tickets/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/allura/admin/tickets/options. Or, if this is a mailing list, you can unsubscribe from the mailing list.

[allura:tickets] #6822 Option to bypass or escape markdown

Posted by Fred Toussi <fr...@users.sf.net>.

Thanks Chris, you did not miss the garbled example. Other stuff I cited was just to show there are code snippets, not to show exact garbled examples.

As I work in the database software field, my suggestion to you is to add a field to the database table used for storing the messages with initially two options. One option is "no markup" and the next option is "markdown". In the future you could add other options such as "html", "xml", "bbcode" or whatever formatting that might be used. This field dictates how you treat the text for rendering on the web or emails. With "no markup" there is no treatment of special characters as markdown codes.

---

** [tickets:#6822] Option to bypass or escape markdown**

**Status:** open
**Created:** Thu Oct 31, 2013 08:41 PM UTC by Dave Brondsema
**Last Updated:** Fri Dec 06, 2013 02:07 PM UTC
**Owner:** nobody

Requested via [forge:feature-requests:#134] and [forge:site-support:#3470]

---

Sent from sourceforge.net because allura-dev@incubator.apache.org is subscribed to https://sourceforge.net/p/allura/tickets/

[allura:tickets] Re: #6822 Option to bypass or escape markdown

Posted by Dave Brondsema <br...@users.sf.net>.

Seems best to wrap content like:  `~~~~\n::text\n$ORIG_CONTENT\n~~~~`

Downsides: literal `~~~~` will mess it up.  And it's monospaced.


---

** [tickets:#6822] Option to bypass or escape markdown**

**Status:** open
**Created:** Thu Oct 31, 2013 08:41 PM UTC by Dave Brondsema
**Last Updated:** Thu Oct 31, 2013 08:43 PM UTC
**Owner:** nobody

All textareas take markdown input, but if you don't realize that and just type or paste something (e.g. code sample, log file) then certain chars may convert into markdown syntax and not render as actually intended.

A checkbox near preview & formatting help buttons could be added.  (Maybe expand to a full toolbar to help with syntax some day).  Changing the data storage for every artifact and the render calls for every artifact is a lot of work and makes the whole system a bit more complex.  If we can use markdown syntax to escape the whole content of the entry, that could work out pretty well I think.

Requested via [forge:feature-requests:#134] and [forge:site-support:#3470]


---

Sent from sourceforge.net because allura-dev@incubator.apache.org is subscribed to https://sourceforge.net/p/allura/tickets/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/allura/admin/tickets/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.

[allura:tickets] #6822 Option to bypass or escape markdown

Posted by Dave Brondsema <br...@users.sf.net>.

Examples of all the block & escaping possibilities, with a markdown syntax and html syntax within each.

-------

    ::text
    indented text [#6822] <b>bold</b>

-------

~~~~
::text
fenced with tildes [#6822] <b>bold</b>
~~~~

-------

<pre>
this is pre [#6822] <b>bold</b>
</pre>

-------

<code>
this is code [#6822] <b>bold</b>
</code>

-------

<div>
this is a div [#6822] <b>bold</b>
</div>

-------

this is <pre>an inline pre [#6822] <b>bold</b> </pre>  foobar

-------

this is `inline backticks [#6822] <b>bold</b>` foo


---

** [tickets:#6822] Option to bypass or escape markdown**

**Status:** open
**Created:** Thu Oct 31, 2013 08:41 PM UTC by Dave Brondsema
**Last Updated:** Thu Oct 31, 2013 08:41 PM UTC
**Owner:** nobody

All textareas take markdown input, but if you don't realize that and just type or paste something (e.g. code sample, log file) then certain chars may convert into markdown syntax and not render as actually intended.

A checkbox near preview & formatting help buttons could be added.  (Maybe expand to a full toolbar to help with syntax some day).  Changing the data storage for every artifact and the render calls for every artifact is a lot of work and makes the whole system a bit more complex.  If we can use markdown syntax to escape the whole content of the entry, that could work out pretty well I think.

Requested via [forge:feature-requests:#134] and [forge:site-support:#3470]


---

Sent from sourceforge.net because allura-dev@incubator.apache.org is subscribed to https://sourceforge.net/p/allura/tickets/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/allura/admin/tickets/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.

[allura:tickets] #6822 Option to bypass or escape markdown

Posted by Chris Tsai <ct...@users.sf.net>.

Hello Fred, I think you're anticipating that Markdown will interfere much more than it actually does. As you may have noticed from your own inline example of "when x > 2 the color is user-defined", there isn't anything there at all that's being affected by markdown formatting.

Further, from the example you cite, it actually comes out quite nicely with the Markdown (dare I say even better than unformatted?). I've copy/pasted the text from that example, which you'll see below:

----

Given the following:

    CREATE TABLE tab ( name VARCHAR_IGNORECASE(255)) INSERT INTO tab VALUES('fileß.txt') <--- Note the 'ß' ! the query: SELECT * FROM tab WHERE name LIKE '%txt%'

returns an empty result set! I would have expected that 'fileß.txt' is returned. Changing the query to:

    SELECT * FROM tab WHERE name LIKE '%tx%' <--- Note the final 't' is missing here

returns 'fileß.txt'!

With name defined as VARCHAR (instead of VARCHAR_IGNORECASE) the first query works as expected.

Is this a bug or some misunderstanding?

(using HSQL 2.3.0)

----

Of course, we can certainly come up with examples where unintended formatting can occur. In particular, the use of \*'s which you noted in [forge:site-support:#3470] would probably be the most common case. But in my experience, the number of incidences of unintended formatting are relatively rare and are IMO worth the trade-off (though, I do appreciate that I encounter different text patterns than you regularly do).

Other more common issues are when folks paste in snippets that start with #'s or >'s, but those should be mitigated by options presented in this ticket.

That said, it would be useful to hear your thoughts on our alternative solutions. Like some of the ones Dave mentions in his last comment.


---

** [tickets:#6822] Option to bypass or escape markdown**

**Status:** open
**Created:** Thu Oct 31, 2013 08:41 PM UTC by Dave Brondsema
**Last Updated:** Thu Dec 05, 2013 06:26 PM UTC
**Owner:** nobody

All textareas take markdown input, but if you don't realize that and just type or paste something (e.g. code sample, log file) then certain chars may convert into markdown syntax and not render as actually intended.

A checkbox near preview & formatting help buttons could be added.  (Maybe expand to a full toolbar to help with syntax some day).  Changing the data storage for every artifact and the render calls for every artifact is a lot of work and makes the whole system a bit more complex.  If we can use markdown syntax to escape the whole content of the entry, that could work out pretty well I think.

Requested via [forge:feature-requests:#134] and [forge:site-support:#3470]


---

Sent from sourceforge.net because allura-dev@incubator.apache.org is subscribed to https://sourceforge.net/p/allura/tickets/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/allura/admin/tickets/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.

[allura:tickets] #6822 Option to bypass or escape markdown

Posted by Fred Toussi <fr...@users.sf.net>.

Follow up from [forge:site-support:#3470] which is a blocker for the project "hsqldb".

It is not just code snippets. Technical exchanges have a high inline code and expression content. For example someone might type: "when x > 2 the color is user-defined" but actually using symbols that get confused with markdown symbols. Users need to enter their posts quickly without having to add markup / markdown code.

It is best to have markdown off / on as a configuration property for the whole forum or for individual posts. The default behavior should be plain text with no markdown. SourceForge of course enhance your markdown support in the future for whoever wants to use it.

If you look at https://sourceforge.net/projects/hsqldb/forums/forum/73674/topic/8714893 you see a simple example with lots of special symbols. Other examples have a wider variety of special symbols.

---

** [tickets:#6822] Option to bypass or escape markdown**

**Status:** open
**Created:** Thu Oct 31, 2013 08:41 PM UTC by Dave Brondsema
**Last Updated:** Wed Dec 04, 2013 03:02 PM UTC
**Owner:** nobody

Requested via [forge:feature-requests:#134] and [forge:site-support:#3470]

---

Sent from sourceforge.net because allura-dev@incubator.apache.org is subscribed to https://sourceforge.net/p/allura/tickets/