<page>
<title>Edgecase_comment_formatting</title>
<author_name>stjohn_piano</author_name>
<content>




<heading_lines>
BRIEF SUMMARY
</heading_lines>


This page describes the format for Edgecase comments and the available markup options.




<heading_lines>
CONTENTS
</heading_lines>


- Brief Summary
- Contents
- Basic Comment Format
- Available Markup Options




<heading_lines>
BASIC COMMENT FORMAT
</heading_lines>


Comments must be written in <link>
<type>article</type>
<article_title>Printable_ASCII</article_title>
<datafeed>edgecase</datafeed>
<datafeed_article_id>91</datafeed_article_id>
<text>Printable ASCII</text>
</link>.

In a comment, the characters <code>[\<, \>, \\]</code> must be preceded by a backslash <code>(\\)</code>.

Example comment (this is comment 0 on the article <link>
<type>article</type>
<article_title>Excerpts_from_The_Once_and_Future_King_by_T_H_White</article_title>
<datafeed>edgecase</datafeed>
<datafeed_article_id>40</datafeed_article_id>
<text>Excerpts from The Once and Future King by T H White</text>
</link>):

<datablock_lines>
In the sentence {The fate of this man or that man was less than a drop, although it was sparkling one, in the great blue motion of the sunlit sea.}, "was sparkling one" should be "was a sparkling one".
</datablock_lines>

The text of this comment will not be altered when it is rendered. The curly brackets do not have a special meaning. They are just a way to indicate that a long sentence is being quoted.




<heading_lines>
AVAILABLE MARKUP OPTIONS
</heading_lines>


Available markup options:
- bold
- italic
- http hyperlink
- datafeed article link


Markup:

- bold:
<datablock_lines>
\<bold\>[text]\</bold\>
</datablock_lines>

- italic:
<datablock_lines>
\<italic\>[text]\</italic\>
</datablock_lines>

- http hyperlink:
<datablock_lines>
\<link\>
\<type\>hyperlink\</type\>
\<reference\>http://the_web_address_goes_here\</reference\>
\<text\>the visible text goes here\</text\>
\</link\>
</datablock_lines>

- datafeed article link:
<datablock_lines>
\<link\>
\<type\>article\</type\>
\<article_title\>the title as written in the original text article goes here\</article_title\>
\<datafeed\>"edgecase" goes here\</datafeed\>
\<datafeed_article_id\>numeric datafeed article id goes here\</datafeed_article_id\>
\<text\>the visible text goes here\</text\>
\</link\>
</datablock_lines>


Example of using bold and italic or both:

<datablock_lines>
This is a comment.

It has \<bold\>some bold text\</bold\> and \<italic\>some italic text\</italic\>.

It also has \<bold\>\<italic\>some bolded italic text\</italic\>\</bold\> and \<italic\>\<bold\>some italicised bold text\</bold\>\</italic\>, which look exactly the same.
</datablock_lines>

This will be rendered as:

<box_text_lines>
This is a comment.

It has <bold>some bold text</bold> and <italic>some italic text</italic>.

It also has <bold><italic>some bolded italic text</italic></bold> and <italic><bold>some italicised bold text</bold></italic>, which look exactly the same.
</box_text_lines>


Example of including an http hyperlink in a comment (this is a part of comment 0 on <link>
<type>article</type>
<article_title>Joining_the_web_of_trust</article_title>
<datafeed>edgecase</datafeed>
<datafeed_article_id>111</datafeed_article_id>
<text>Joining the web of trust</text>
</link>):

<datablock_lines>
you can message deedbot/any user privately directly, you don't need to join some channel first; and re newcomers, it's usually safer for themselves to join one of the lords' channels first, really (e.g. #asciilifeform, #trinque, #eulora)
\<link\>
\<type\>hyperlink\</type\>
\<reference\>http://btcbase.org/log/2019-05-22#1914934\</reference\>
\<text\>[Source]\</text\>
\</link\>
</datablock_lines>

This will be rendered as:

<box_text_lines>
you can message deedbot/any user privately directly, you don't need to join some channel first; and re newcomers, it's usually safer for themselves to join one of the lords' channels first, really (e.g. #asciilifeform, #trinque, #eulora)
<link>
<type>hyperlink</type>
<reference>http://btcbase.org/log/2019-05-22#1914934</reference>
<text>[Source]</text>
</link>
</box_text_lines>


Example datafeed article link:

<datablock_lines>
\<link\>
\<type\>article\</type\>
\<article_title\>Excerpts_from_The_Once_and_Future_King_by_T_H_White\</article_title\>
\<datafeed\>edgecase\</datafeed\>
\<datafeed_article_id\>40\</datafeed_article_id\>
\<text\>Excerpts from The Once and Future King by T H White\</text\>
\</link\>
</datablock_lines>

This will be rendered as:

<box_text_lines>
<link>
<type>article</type>
<article_title>Excerpts_from_The_Once_and_Future_King_by_T_H_White</article_title>
<datafeed>edgecase</datafeed>
<datafeed_article_id>40</datafeed_article_id>
<text>Excerpts from The Once and Future King by T H White</text>
</link>
</box_text_lines>










</content>
</page>
