The Trisquel Wiki Seems Messed Up

6 replies [Last post]
jxself
Offline
Joined: 09/13/2010

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.

AttachmentSize
screenshot.png603.89 KB
J.B. Nicholson-Owens
Offline
Joined: 06/09/2014

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.

jorgesumle
Offline
Joined: 06/01/2016
albertoefg
Offline
Joined: 04/21/2016

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.

Pandya
Offline
Joined: 11/11/2014

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.

Screenshot from 2017-01-15 13:27:25.png