Bold is overloaded. I use it in revisions to mark text added in a revision but I also use it for other purposes like quoting and emphasis. These conflict and confuse the Markdown -> HTML translation in revisions.rb. A viable solution here is to use <ins> to mark text added in a revision.
Git diff doesn't respect (or understand) markdown formatting. So, it sometimes creates diff tokens such that markdown links get split into multiple diff tokens. For example, From [-Robert Pirosh's [extraordinarily memorable-]{+the [memorable+} cover [-letter](https://lettersofnote.com/2012/03/13/i-like-words/):-]{+letter](https://lettersofnote.com/2012/03/13/i-like-words/) Robert Pirosh submitted for a copywriting job:+}. I have two solutions: 1) find and replace incomplete MD formatting in each diff token or 2) configure the git diff command in revisions.rb by setting the --word-diff-regex option to customize how words are calculated.
Very similar to Problem 2. Git sometimes creates diff tokens such that markdown tokens get split partially into a diff token and partially out of a diff token.
There are a few problems.
Problem 1
UPDATE: Fixed by #37
Bold is overloaded. I use it in revisions to mark text added in a revision but I also use it for other purposes like quoting and emphasis. These conflict and confuse the Markdown -> HTML translation in
revisions.rb
. A viable solution here is to use<ins>
to mark text added in a revision.e.g. for okjuan.me/vbook/use-words/revs/9/
Problem 2
UPDATE: Fixed by #37
Git diff doesn't respect (or understand) markdown formatting. So, it sometimes creates diff tokens such that markdown links get split into multiple diff tokens. For example,
From [-Robert Pirosh's [extraordinarily memorable-]{+the [memorable+} cover [-letter](https://lettersofnote.com/2012/03/13/i-like-words/):-]{+letter](https://lettersofnote.com/2012/03/13/i-like-words/) Robert Pirosh submitted for a copywriting job:+}
. I have two solutions: 1) find and replace incomplete MD formatting in each diff token or 2) configure thegit diff
command inrevisions.rb
by setting the--word-diff-regex
option to customize how words are calculated.e.g. also for okjuan.me/vbook/use-words/revs/9/
Problem 3
Very similar to Problem 2. Git sometimes creates diff tokens such that markdown tokens get split partially into a diff token and partially out of a diff token.
e.g. for okjuan.me/vbook/tell-a-story-3/revs/2/
e.g. for okjuan.me/vbook/use-words/revs/7/
Problem 4
Markdown quote
>
not formatted.