Skip to content

Code snippet rendering issue since markdeep 1.18 #105

@SimonMarquis

Description

@SimonMarquis

Markeep recent update broke the code snippets of this documentation.
To be more precise, this happend in version 1.18.
While undocumented, this breaking change actually enforces what the specs mentions:

Set off large blocks of code using equal-length strings of tilde ~ or back-tick ` characters.

Unfortunately, the documentation pages here are using a non-equal length, for example:

Here is an example of lint warnings produced by this check:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~text
res/values/aaptcrash.xml:5:Error: This construct can potentially crash
aapt during a build. Change @+id/titlebar to @id/titlebar and define the
id explicitly using <item type="id" name="titlebar"/> instead.
[AaptCrash]
&lt;item name="android:id"&gt;@+id/titlebar&lt;/item&gt;
--------------------------------------------
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

It is as if it tries to use the same length, but including the language markers.

And this produces an erroneous output that can break the page rendering even more:

Image

I'll prepare a PR to fix this globally.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions