The Trisquel Wiki Seems Messed Up
Why does all of the documentation look so bad?
An example: https://trisquel.info/en/wiki/documentation but every page seems to look like this.
| Attachment | Size |
|---|---|
| screenshot.png | 603.89 KB |
name at domain wrote:
> Why does all of the documentation look so bad?
It looks like markup that isn't being processed with the appropriate markup
program, so you're seeing the markup instead of the processed output:
- links show up as URLs instead of being clickable
- headers show up as "==foo==" instead of being rendered on new lines in an
appropriately larger font
- lists show up with asterisks instead of being formatted so each item in
the list is on its own line and a proper bullet character is used.
and so on. And you're also seeing a fill justification which makes the
markup look like a wall of text instead of a series of (in my opinion,
easier to read) left-justified paragraphs.
After reading this I searched for a software that helps with this.
I found pandoc http://pandoc.org/
sudo apt-get install pandoc
It can convert MediaWiki format to html format
The only thing that have to take into account is not to copy directly from wiki (as it is messed up), instead, go first to "Edit" and copy the text from there, as it will have the proper format.
Then using pandoc: (see http://pandoc.org/getting-started.html#step-6-converting-a-file for more information, also http://pandoc.org/MANUAL.html#using-pandoc)
pandoc -f mediawiki -t html document
Then you can replace the text in the same Edit form and lastly change at the bottom from Wiki format to html format (otherwise it will be rendered as mediawiki markdown and html won't work).
Save it and now it will work :)
We are doing this in spanish wiki and it seems better now.
Yes, I had contacted about that issue when Documentation and other wiki pages was looking bad but haven’t got reply yet. Though "Documentation" and some pages looks fine now.
