additional polish with markdownlint

Accounts for most of the remaining suggestions by markdownlint.[1]

[1] https://github.com/markdownlint/markdownlint, version 0.12.0.
This commit is contained in:
Norwid Behrnd 2022-11-30 14:22:46 +01:00
parent 7cf9a2b7aa
commit eddf5accb8

View File

@ -37,7 +37,6 @@ review them more effectively and/or individually.
`file language.html.markdown` You will see this if it uses a BOM:
`UTF-8 Unicode (with BOM) text`.
### Header configuration
The actual site uses Middleman to generate HTML files from these Markdown ones.
@ -85,8 +84,12 @@ addition or not.
You can build the site locally to test your changes. Follow the steps below.
* Install Ruby language runtime and RubyGems. See [here](https://middlemanapp.com/basics/install/) for more details.
* Clone or zip download the [learnxinyminutes-site](https://github.com/adambard/learnxinyminutes-site) repo.
* Install Ruby language runtime and RubyGems. See
[here](https://middlemanapp.com/basics/install/)
for more details.
* Clone or zip download the
[learnxinyminutes-site](https://github.com/adambard/learnxinyminutes-site)
repository.
* `git clone https://github.com/adambard/learnxinyminutes-site`
* Install Middleman and other required dependencies using Bundler.
* `cd learnxinyminutes-site/`
@ -100,6 +103,6 @@ You can build the site locally to test your changes. Follow the steps below.
* `cd source/docs/`
* `git clone https://github.com/YOUR-USERNAME/learnxinyminutes-docs ./source/docs/`
* Build the site or run a development server to test your changes (NOTE: run
these commands at `learnxinyminutes-site/`).
these commands at `learnxinyminutes-site/`).
* Build - `bundle exec middleman build`
* Dev server - `bundle exec middleman --force-polling --verbose`