manual: HTML updates in lib/db and db manual pages and README files#4751
manual: HTML updates in lib/db and db manual pages and README files#4751neteler merged 4 commits intoOSGeo:mainfrom neteler:manual_SQL_updates
Conversation
This PR provides minor HTML fixes to `lib/db/` and `db/` manual related files: - convert several `README` to `README.md` - update selected broken URLs - partially sync `grass-mysql.html` and `grass-mesql.html` incl. section order
|
Did you use prettier (like in superlinter) to find problematic/unparsable html? |
For markdown, I used:
on the various |
|
In the grass-addons, I used prettier and fixed the html parsing errors a while ago, but did not apply the formatting fixes, as it was way too disruptive. But many places the hrefs without quotes were flagged, or tags not in order. |
|
I tried with |
I made a quick run to see if there were some parsing errors that might be problematic when converting. Take a look at the 5 files that have red lines in https://github.com/echoix/grass/actions/runs/12001379426/job/33451802353?pr=303#step:4:8310 One is an decimal character entity missing its semicolon; |
This test looks good and useful to me: so it is informative yet it does not modify the entire HTML code. The identified HTML errors might be fixed along with the submission of a new superlinter HTML linting PR (in case you plan that).
Concerning one of the linting errors: |
|
(other HTML errors addressed in #4757) |
Problem is: they do. That's what all the warnings (in gray) are. I didn't find a way to get what I wanted for grass-addons, so I ended up disabling.
Not for now. I'm hoping they get replaced by MD.
:) |
…4751) This PR provides minor HTML fixes to `lib/db/` and `db/` manual related files: - convert several `README` to `README.md` - update selected broken URLs - partially sync `grass-mysql.html` and `grass-mesql.html` incl. section order - fix typo: statemets -> statements Extra: - avoid <br> tags within <em> as not converted properly to Markdown
This PR provides minor HTML fixes to
lib/db/anddb/manual related files:READMEtoREADME.mdgrass-mysql.htmlandgrass-mesql.htmlincl. section orderExtra:
<br>tags within<em> .. </em>as this will not be properly converted to Markdown