Docs: Code blocks on some pages appear to escape `"` character

Created on 14 Jun 2019 · 8Comments · Source: knative/docs

Expected Behavior

Code blocks should not escape " characters

Actual Behavior

Code blocks appear to escape " as "

Steps to Reproduce the Problem

go to https://knative.dev/docs/serving/samples/secrets-go/

Additional Info

Additional context
I'm on Firefox 67.0.2 on MacOS 10.14.5

Screenshot:
Screen Shot 2019-06-14 at 2 03 37 PM

kinbug priorit1

Source

kwyn

Most helpful comment

@RichieEscarez I'm guessing this is happening at build time, since the source seems correct?

samodell on 17 Jun 2019

👍2

All 8 comments

Just noticed this.
Was going to make a PR to a doc I noticed to correct a python script, but they appear fine in the README files.

sfxworks on 16 Jun 2019

This also applies to single quotes '

sfxworks on 16 Jun 2019

@RichieEscarez I'm guessing this is happening at build time, since the source seems correct?

samodell on 17 Jun 2019

👍2

Where does the build code live for the document website out of curiosity?

kwyn on 20 Jun 2019

Our website content is located in knative/website. Regarding this issue, i've found a solution (and the cause, which i unintentionally introduced here).

Basically, Hugo had a breaking change type fix for how it treats 'shortcodes'. It improved things by sending the shortcode content to the markdown processor. You can now define if a shortcode gets sent to the markdown processor (use {{% ...%}} vs {{< ... >}}).

I found that change can also breaks things (like our double processed quotes) depending on syntax of previously defined shortcodes. The issue in our site is that our use of the readfile shortcode ends up sending content to the markdown processor twice. Ive determined how to fix this and need to set up a clean branch before opening a PR. In this effort, ive also determined how to "include" code files, so i also need to separate out that content for a separate PR (re PR #1409 ).