Skip to content

sajozsattila/mur2_editor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Overview of the μr² editor

The μr² editor an easy to use, versatile and comprehensive text editor for academic writing.

Reasons to try:

  • Complicated tables: row and column merge, cells in multiple lines, multiple tbody
  • Collaborative real-time editing.
  • Citation and Bibliography support.
  • Comments, Editor notes
  • Fully supports LaTeX math input as SVG output. It means you can use the output without Javascript, for example on Medium.com. Example
  • The user interface is minimal, helping to focus on what you are writing
  • Easily export your document to PDF, ePuB, LaTeX, HTML and Microsoft Word
  • Alternatively, publish your work directly to Wordpress.com, Medium.com or on our page
  • It is fast; the simple formatting saves a significant amount of time over other word processors
  • It is easy to learn; it uses Markdown syntax, which is so simple that one can barely call it “syntax”

Most academic articles are the result of shared effort by multiple Writers. To help Writers work together, the μr² supports collaborative real-time editing. Any registered user is welcome to work on your document and you will be able to edit it simultaneously.

Examples

Tables

Row and columns merge, with multiple tbody:

|               |          Grouping             ||         Grouping 2         ||  Not Grouped    |
| First Header  | Second Header | Third Header   | Forth Header | Fifth Header | Sixth Header    |
| ------------- | :-----------: | -------------: | :----------: | :----------: | --------------- |
| Tall Cell     |          *Long Cell*          ||         *Long Long Cell*                    |||
| ^^            |   **Bold**    | 1. first item  | *Italic*     | 3. third item | + first point  |\
| ^^            |               | 1. second item |              | 1. forth item | + second point |

| New section   |     More      |         Data   | ... - -- --- |||
| And more      | With an escaped \|          || "Try 'quotes' in quotes "         |||
[Compicated table]

Output:

Table in μr² editor

Mathematical expressions

The μr² renders mathematics from LaTeX expressions inside your markdown file. You can use inline: $$ \mu r^2 $$, block:

$$ \text{Bayes' theorem: } P(A\mid B) = \frac{P(B \mid A) P(A)}{P(B)} $$ 

Which will be rendered like:

Block mathematical expressions

Or numbered and linked blocks:

$$ \text{Euler's identity: } e^{i \pi } + 1 = 0 $${#eq:1}

Which will be looking like:

Numbered mathematical expressions

The output is rendered as SVG images, this means you can use them everywhere, even when you have no JavaScript.

Citations and Bibliography

The citations are very simple: this is a citation [@knuthwebsite], and another one with page info [@einstein{p. 900}], one with a prefix [@knuthfa{See}{chapter 1.2}]. The bibliography information you can write in standard BibLaTeX format:

@article{einstein,
    author =       "Albert Einstein",
    title =        "{Zur Elektrodynamik bewegter K{\"o}rper}. ({German})
    [{On} the electrodynamics of moving bodies]",
    journal =      "Annalen der Physik",
    volume =       "322",
    number =       "10",
    pages =        "891--921",
    year =         "1905",
    DOI =          "http://dx.doi.org/10.1002/andp.19053221004",
    keywords =     "physics"
}

You can choose Citation Style Language styles to render them, for example, you can use APA:

APA^[<sup class="footnote-ref"><a href="#fn1" id="fnref1">[1]</a></sup>] formatted citations

Or IEEE:

IEEE formatted citations

The Bibliography will be automatically included at the end of the generated output, like for the above example in IEEE style:

IEEE formatted Bibliography

Collaborative real-time editing

With μr², you can share collaborative documents, thanks to the synchronization mechanism. The collaborating is real-time, so there is no merge mechanism. Simple multiple writers can work on the same document at the same time. For a recorded example check out the bellow video:

Example video

Editorial changes

If multiple people are working on the same document, track changes are necessary. This is not part of the standard Markdown but it is especially useful. The μr² editor uses CriticMarkup syntax for this. It is very easy, just switch on in the toolbar, and you can create {==highlights==},
{>>comments,<<} {++additions++}, {--deletions--} or {~~bad~>good~~} substitutation.

Some details

For detailed usage of the editor please read our manual.

Why Markdown?

Markdown uses a plain text formatting syntax aimed at making writing easier. The philosophy behind it; a document should be readable without tags everywhere but still be able to add text modifiers such as lists, bold text and italics quickly. It's an alternative to WYSIWYG (what you see is what you get) editors.[2]

Here’s a quick example of how to emphasize words with Markdown, you simply enclose them in * (asterisks). So, *emphasize word* would look like emphasize word in the final document.

We also help if you are new to markdown or can't remember any of the syntaxes. You can use the toolbar controls within the editor or open up the Markdown cheatsheet in the menu.

Why Javascript?

There is usually a tradeoff between security and usability with two general approaches:

  • The data in digital publications are stored on a remote server and delivered over the internet via a web browser. Is this secure? At μr² we say that it isn't and we are not just referring to 'man-in-the-middle' attacks. If your provider goes offline, all of your work will be lost. It is useable? Yes, you can access your data from anywhere with an internet connection.
  • Download and install the platform locally. It is secure? Yes, it is more secure than the previous option, however, you need to install the platform on every device.

Using Javascript helps μr² to better answer these questions. The editor can only be accessed via HTTPS (secure communication over a computer network) from anywhere with an internet connection, so you do not need to install anything. However, as it is a client-side technology, after the first load it can work even when you drop your connection in the meantime.[3] However, your work can be stored only locally.[4]

Academic writing and publishing

We aim to support academic quality writing which is a huge task that very few publication platforms offer. We support LaTeX type mathematical input, footnotes, cross-reference, equation numbering, citations and bibliography and editorial changes to name a few.

In the μr² editor, you can create HTML, PDF, ePUB, LaTeX or Microsoft Word with one click. You can also directly publish your document in Wordpress.com or Medium. If you don't have to place to publish it, the project has a free to use webpage where work can publish. There we also provide extra features for registered users.

Self hosting

If you would like to self hosting the editor the easiest to dowload mur2_docker.

How you can help?

If you would like to help, there is plenty of things to do. The most simple one: use the editor and if you find some error or you just have a good idea, do not keep it for yourself.

If you know JavaScript, Python, HTML or CSS you can collaborate in the development also. I am not a frontend developer, so I am sure there is plenty of place for improvement there. Also, a lot of tests is waiting to be written.

I am also looking for translators of the frontend. For this do not need any IT knowledge. If you speak English and any other language just have a look a messages.po files on the Gihub.

Thanks

This editor based on multiple open source project, we would like to say many thanks to them:

Endnotes

  1. The 6th edition. ↩︎

  2. Like Microsoft Word, Apple’s Pages or Google Docs ↩︎

  3. Which is unfortunately common in our mobile World. ↩︎

  4. But if you wish to store them online, and access them from everywhere. Currently, we have some space on the demo server, so after registration, you can store them there. ↩︎