Fix edge cases in link check

[josesimoes]

• Add processing for HTML link IDs in format ## <a id=\"i_am_an_id\">Title for ID</a>.
• Replacer now replaces ?.
• Replacer doesn't replace _ anymore as that's a valid char for a tile.

Checked locally by validating this repo/commit: nanoframework/nanoframework.github.io

Fixing issues wrongly reported in this build: https://dev.azure.com/nanoframework/nanoframework%20docs/_build/results?buildId=38903&view=logs&j=12f1170f-54f2-53f3-20dd-22fc7dff55f9&t=72c3483f-759b-5fe1-97d0-7523409e045c

D:\a\1\s\content\architecture\simplifications-and-trade-offs.md 33:123
In doc link was not found 'string-format-examples.md#d-decimal'. Make sure you have all lowercase, remove '*' and replace spaces by '-'.
D:\a\1\s\content\architecture\simplifications-and-trade-offs.md 34:127
In doc link was not found 'string-format-examples.md#f-fixed-point'. Make sure you have all lowercase, remove '*' and replace spaces by '-'.
D:\a\1\s\content\architecture\simplifications-and-trade-offs.md 35:123
In doc link was not found 'string-format-examples.md#g-general'. Make sure you have all lowercase, remove '*' and replace spaces by '-'.
D:\a\1\s\content\architecture\simplifications-and-trade-offs.md 36:122
In doc link was not found 'string-format-examples.md#n-number'. Make sure you have all lowercase, remove '*' and replace spaces by '-'.
D:\a\1\s\content\architecture\simplifications-and-trade-offs.md 37:127
In doc link was not found 'string-format-examples.md#x-hexadecimal'. Make sure you have all lowercase, remove '*' and replace spaces by '-'.
D:\a\1\s\content\building\cmake-presets.md 13:21
In doc link was not found '../faq/automatic-firmware-updates.md#how-to-prevent-a-board-from-updating-if-working-on-a-custom-firmware'. Make sure you have all lowercase, remove '*' and replace spaces by '-'.
D:\a\1\s\content\building\cmake-presets.md 14:36
In doc link was not found 'build-instructions.md#build_version-matching'. Make sure you have all lowercase, remove '*' and replace spaces by '-'.
D:\a\1\s\content\building\cmake-presets.md 112:61
In doc link was not found '../architecture/wire-protocol.md#crc32-validatons'. Make sure you have all lowercase, remove '*' and replace spaces by '-'.
D:\a\1\s\content\contributing\contributing-workflow.md 91:22

[Ellerbach]

Any source document that breaks to 1: be able to test, 2: understand if that's already formed correctly :-)

[josesimoes]

Yes! That's on the comment above.

1. clone repo above (in that commit, which is the latest)
2. run tool: it shows those errors as in the AZDO log

[josesimoes]

As for docfx support for HTML links: https://dotnet.github.io/docfx/tutorial/links_and_cross_references.html#links-in-inline-html Plus those links as they are now are correctly processed by docfx if one skips this check. As you can see here.

[Ellerbach]

So for the record, this pattern seems to be the issue that your PR is fixing:

For example in this file: https://github.com/nanoframework/nanoframework.github.io/blob/pages-source/content/architecture/simplifications-and-trade-offs.md

[josesimoes]

Dropping PR.