Discuto

Discuto

How Discuto's parser works


Today we will talk about the Discuto document parser and the way it transforms your document into a live discussion. There are some broad lines you will have to follow for the parser to do what you want and hopefully those are not too strict and can be followed without big changes to your document.  Some of those are standards you already follow in your normal docs.

Paragraphs :

The most important issue to understand is how paragraph are automatically created by Discuto. Paragraphs are triggered by the new line command (usually the “Enter” key in every standard word editor). In html files the paragraph tag (<p>) is used to trigger paragraphs.

Important note : “Carriage return” - usually created by pressing “Shift+Enter” - does not create a new paragraph but only makes a new line inside the same paragraph, as it does in any word editor.

Headlines / Headings :

Discuto interprets headings as being a new “section” of the document and thus a heading always makes a new paragraph separating what was “before the heading” and “after the heading”.

The Headings themselves are transformed into a special paragraph that can not be commented or voted since usually they do not contain actual content to be discussed but rather just an introduction to the next subject. Despite this you can change them to a normal paragraph as well if it makes sense in your particular case.

Tables :

Tables in documents are kept as they are and not split up into rows. Additionally, the each cell within a table is given the same amount of space to make best use of the limited space - particularly on mobile devices.

If you intend to discuss each row or cell separately you have to break the table into the units you want to discuss (e.g. cells/rows) and to separate them by new line commands (i.e “enter”). When uploaded, this creates a paragraph for each unit that can then be commented and voted by participants.

Images :

Images are gathered from the word document and uploaded into Discuto, scaled according to the device on which they are displayed as they are part of the Responsive Design architecture. This is also the reason why some images are displayed with a lower pixel density than in the Word file.

General Layout (font type, font size etc..) :

Discuto harmonizes the layout of discussions so that users have the same experience while going through different discussions, i.e. fonts , font sizes, headings size, tables size and other layout related aspects are harmonised between documents.

Final note :

So taking in consideration these aspects the first two aspects mentioned here will be the more important so that the transformed document matches the original doc file. Considering the other aspects is important to give a good presentation and a good look and feel to the people joining your discussion.

Should you be unhappy how the uploaded document is presented in Discuto you have basically two options: Change the formatting of the word document according to the few rules outlined above and reuploading the document or to use the online tools to edit the paragraphs (see our FAQ section). Should there be only minor things to edit we recommend to use the online editor. For all other cases please work on the formatting of the text file and upload it again.  


Feel free to contact us in case of any question you have to office@discuto.io or through our contact form.



Login or register to post comments
image_ava
lifetime 01.12.2019 - 14:51
It is perfect time to make some plans for the future and it is time to be happy. I've read this post and if I could I desire to suggest you some interesting things or suggestions. Perhaps you could write next articles referring to this article. I want to read more things about it! proeprty law
image_ava
lifetime 01.12.2019 - 15:17
I wish more writers of this sort of substance would take the time you did to explore and compose so well. I am exceptionally awed with your vision and knowledge. handyman
image_ava
lifetime 01.12.2019 - 15:36
Really impressed! Everything is very open and very clear clarification of issues. It contains truly facts. Your website is very valuable. Thanks for sharing. tree removal information
image_ava
lifetime 01.12.2019 - 16:00
I can see that you are an expert at your field! I am launching a website soon, and your information will be very useful for me.. Thanks for all your help and wishing you all the success in your business. tree service
image_ava
lifetime 02.12.2019 - 07:50
A debt of gratitude is in order for the blog entry amigo! Keep them coming... tree removal information
image_ava
lifetime 02.12.2019 - 08:04
Glad to chat your blog, I seem to be forward to more reliable articles and I think we all wish to thank so many good articles, blog to share with us. tree trimming guide
image_ava
lifetime 03.12.2019 - 14:11
I recently found many useful information in your website especially this blog page. Among the lots of comments on your articles. Thanks for sharing. The Underdog Advantage
image_ava
lifetime 03.12.2019 - 14:37
I adore your websites way of raising the awareness on your readers. Text Chemistry
image_ava
lifetime 03.12.2019 - 17:54
Superbly written article, if only all bloggers offered the same content as you, the internet would be a far better place.. Obsession Method
image_ava
lifetime 04.12.2019 - 10:31
This is an excellent post I seen thanks to share it. It is really what I wanted to see hope in future you will continue for sharing such a excellent post. Free Logo Creator
image_ava
lifetime 04.12.2019 - 13:11
Thanks a lot for one’s intriguing write-up. It’s actually exceptional. Searching ahead for this sort of revisions. Numerologist
image_ava
lifetime 04.12.2019 - 17:48
This article gives the light in which we can observe the reality. This is very nice one and gives indepth information. Thanks for this nice article. His Secret Obsession
image_ava
lifetime 05.12.2019 - 09:59
Awesome blog. I enjoyed reading your articles. This is truly a great read for me. I have bookmarked it and I am looking forward to reading new articles. Keep up the good work! Keto Diet
image_ava
lifetime 07.12.2019 - 12:29
I am always searching online for articles that can help me. There is obviously a lot to know about this. I think you made some good points in Features also. Keep working, great job ! The Knowledge Business Blueprint
image_ava
lifetime 07.12.2019 - 12:39
I am impressed by the information that you have on this blog. It shows how well you understand this subject. The Knowledge Business Blueprint Review
image_ava
lifetime 08.12.2019 - 13:13
I would like to say that this blog really convinced me to do it! Thanks, very good post. Unlock Your Hip Flexors
image_ava
lifetime 10.12.2019 - 05:32
Great post I would like to thank you for the efforts you have made in writing this interesting and knowledgeable article. Cinderella Solution Review
image_ava
lifetime 10.12.2019 - 13:16
I liked your article and I hope you will have many entries or more Halki Diabetes Remedy Review
image_ava
robinjack529@gm... 26.01.2020 - 11:08

CBD is cannabidiol and is extracted from the cannabis plant imp source