Closed oraNod closed 7 months ago
Here are some examples of things that need to be fixed.
The conversion process inserted several backslash characters \
that get rendered in the output and prevent line breaks so paragraphs get globbed together.
Here is an example from the command-module-deep-dive-for-networks.md
file.
be automated. Ansible is more than configuration management, it allows
network operators the freedom to decouple themselves from routine tasks
and save themselves time.\
\
There are command modules for a variety of platforms, including all the
This renders as:
be automated. Ansible is more than configuration management, it allows
network operators the freedom to decouple themselves from routine tasks
and save themselves time.
There are command modules for a variety of platforms, including all the
This renders as:
In several files text is wrapped in square brackets []
and has inline CSS like this:
[\
Basic Command Module
Usage]{style="color: inherit; font-size: 30px; background-color: transparent;"}
The solution here is to remove the brackets so that it's just plain text with whatever the appropriate markdown formatting might be.
For example, this would create a second level heading:
## Basic Command Module
Here is another example in the ansible-and-infoblox-roles-deep-dive.md
file:
records based on a user-supplied
[host_count]{style="font-family: 'courier new', courier;"} value. This
demo shows the power of
This is a pretty straightforward fix:
records based on a user-supplied
`host_count` value. This
demo shows the power of
Follows up on #300
A number of migrated blog posts contain weird formatting as a result of the conversion process. The purpose of this task is to inspect the markdown files and manually clean them up where needed.
Here is the list of suspected markdown files: