aeolus
The goal of aeolus is to create better, more semantic linebreaks in your Markdown file. aEOLus, get it? :wink:
Installation
You can install the development version of aeolus like so:
pak::pak("maelle/aeolus")Why have semantic linebreaks?
For any Markdown parser the two following code chunks are the same:
This is a sentence. This is another
sentence.This is a sentence.
This is another sentence.However, the second one will make your work easier when you use version control. Git treats code by line so if lines are logical units as opposed to random units or units of a certain length, the Git diff is better.
If you change one sentence in a paragraph, and that paragraph is a single line, the Git diff is less readable.
With semantic linebreaks, code suggestions in GitHub Pull Requests are easier to make and use.
More information: https://sembr.org/.
Example
This is a basic example which shows you how to solve a common problem:
library(aeolus)
markdown_file <- system.file("example.md", package = "aeolus")
readLines(markdown_file)#> [1] "This is a **sentence**. This is another [sentence](https://github.com)."
#> [2] ""
#> [3] "In this paragraph"
#> [4] "I made "
#> [5] "random line "
#> [6] "breaks. How annoying"
#> [7] "is it?!"
#> [8] ""
#> [9] "```md"
#> [10] "This is a sentence. This is another"
#> [11] "sentence."
#> [12] "```"
#> [13] ""
#> [14] "This is a very long paragraph very very long without any breaks whatsoever which is sad, because who wants to get such a git diff."
#> [15] ""
#> [16] "1. thing"
#> [17] "2. other thing"
#> [18] ""
#> [19] "- item 1"
#> [20] "- item 2"
#> [21] "- item 3"
#> [22] ""
#> [23] "**What is wrong with bold text?** What?"
#> [24] ""
#> [25] ""unleash(markdown_file)
readLines(markdown_file)#> [1] "This is a **sentence**."
#> [2] "This is another [sentence](https://github.com)."
#> [3] ""
#> [4] "In this paragraph I made random line breaks."
#> [5] "How annoying is it?!"
#> [6] ""
#> [7] "```md"
#> [8] "This is a sentence. This is another"
#> [9] "sentence."
#> [10] "```"
#> [11] ""
#> [12] "This is a very long paragraph very very long without any breaks whatsoever which is sad, because who wants to get such a git diff."
#> [13] ""
#> [14] "1. thing"
#> [15] "2. other thing"
#> [16] ""
#> [17] "- item 1"
#> [18] "- item 2"
#> [19] "- item 3"
#> [20] ""
#> [21] "**What is wrong with bold text?**"
#> [22] "What?"
#> [23] ""
#> [24] ""