"Code Block" on GitHub Pages is not rendering and throws an error

[jharris1993]

Situation:
I am trying to teach myself the finer points of GitHub pages by cloning an existing documentation repository and then mess with it to see what happens.

The repository I decided to clone was the Raspberry Pi documentation repository located here:
GitHub - raspberrypi/documentation: Official documentation for the Raspberry Pi

The file in question is the cmio-camera.md file.
The original file is located here:
documentation/cmio-camera.md at 6d7da8ebe337d4067a1e6fe53e637a12c3505ed5 · raspberrypi/documentation · GitHub

My copy of it is located here:
Test_Using_Raspberry_Pi_Documentation/cmio-camera.md at 18f3a8ad1d5b9575cec6269d567469f32a02765f · jharris1993/Test_Using_Raspberry_Pi_Documentation · GitHub

The problem I am experiencing:

When I try to create a GitHub page based on the material downloaded, I get the following error:

Your site is having problems building1192×145 46.1 KB

What I have done:

1. The entire repo would not build since there was no index.md file.
   I copied the README.md file and renamed it index.md.

2. The modified repo then began to fail on cmia-camera.md with a particular line and variable not closed correctly.

3. Reading the documentation on formatting, it told me that code blocks should be indented by four spaces and made no mention of back-ticks. It also said that anything inside the indented part would NOT be parsed, but would be presented verbatim.

4. I removed the back-ticks and replaced them with indenting the two lines four spaces.
   This also did not work. I tried [code] and [/code] delimiters; they didn’t work either.

This is the block of offending code.

```
MMAL_PARAMETER_INT32_T camera_num = {{MMAL_PARAMETER_CAMERA_NUM, sizeof(camera_num)}, CAMERA_NUMBER};
status = mmal_port_parameter_set(camera->control, &camera_num.hdr);
```

When I “view” the page, everywhere the three back-ticks surround a block, it’s properly rendered as a code block. Obviously it works on the Raspberry Pi documentation pages, as it is up and published.

When I change the back-ticks to a four-space indent, the same thing happens - it formats correctly when “viewed” but throws the same error when I try to build the page.

If someone can tell me why this is not compiling correctly, I wold greatly appreciate it.

Thanks!

Jim “JR”

[yamiacat]

Hey @jharris1993! 👋

Hmmm, so, the raspberrypi/documentation repo you link to isn’t actually generating a GitHub Pages site, so they’re not using GitHub’s build system. How they process markdown during the page build process might be totally different.

On GitHub, at least, the code block you posted is causing problems because Jekyll’s parser treats any code using double curly braces {{ text }} or curly braces and percent signs {% text %} that’s included in inline or fenced code blocks as if it’s a Liquid tag.

To stop this happening you’ll need to surround any affected code blocks with some tags to tell Jekyll to ignore them:

---

{% raw %}

your code here

{% endraw %}

---

You can also surround these tags with Markdown comments, meaning they won’t render on GitHub.com:

---

[//]: # ({% raw %})

your code here

[//]: # ({% endraw %})

---

Hope this helps!

[jharris1993]

Perhaps this could be added to the documentation for code blocks since we can’t assume that any language is going to conform to Liquid’s standards.

Or perhaps an even better way would be to instruct Liquid that anything within a code block is automatically assumed to be “raw” which is the universally expected behavior of code blocks.

Thanks for your help, it’s appreciated!

[jingydz]

“Unable to render code block”

https://github.com/PopicLab/cue/blob/master/notebooks/tutorial.ipynb

[Eurekha-K]

I am getting the same error .
Could you tell me how did you resolve this?

[Eurekha-K]

From the past few days I have been trying to solve this .Help me with this error