Wiki style guide

[Sammy McSam]

Just came across this thread and added to the wiki formatting page today, let me know if you have any questions on any of the edits or templates.

[kevan]

Just came across this thread and added to the wiki formatting page today, let me know if you have any questions on any of the edits or templates.

I saw your updates from a couple of weeks ago. This is good comprehensive stuff, but maybe a little too technical in places, for a casual rule writer who just wants to know how to make bullet points show up.

Has this whole issue of wiki rules markup ever made it to the eyes of any BGA staff? I've been noticing more and more rules writers independently adopting their own workarounds for it (particularly the heading overlap bug), and nearly all of the problems could be fixed by adding a few lines of "wikicontent" markup to the common.css file.

Bullet points (which are probably the most important issue in the context of game rules which often present lists of turn options or game objects, and which BGA hasn't displayed for over three years now) would work again today if someone could just add:

Code: Select all

.wikicontent li { list-style: outside; margin: 0em 1em; }

[Sammy McSam]

Thanks for the feedback. I've made HTML/CSS less prominent and regrouped by list type.

A suggested plan of action, not necessarily in this order:

1. Share bug report(s) to increase votes.
2. Test CSS workarounds and agree on a set of recommended CSS rules. | Wiki reference
3. Ask more users to test the recommended CSS rules and provide any feedback. | bga-developers discord
4. Add specific & concise issue descriptions and relevant CSS rules to existing bug reports.
5. Request the chrome extension developers use the recommended CSS rules. | Wiki reference
6. As more users install the chrome extension, BGA staff will take more interest in the CSS and hopefully fix themselves.

[Sammy McSam]

nearly all of the problems could be fixed by adding a few lines of "wikicontent" markup to the common.css file.

My CSS suggestion:

Code: Select all

.wikicontent ul {
margin:.25em;
padding:.25em 1em;
}

.wikicontent ol {
margin:.5em;
padding:.25em 1.25em;
}

.wikicontent ul li {
list-style-type:disc;
}

.wikicontent ol li {
list-style-type:decimal;
padding-inline-start:.25em;
}

.wikicontent dd {
padding-inline-start:1em;
}

.wikicontent table {
width:auto;
margin:1em 0;
}

.wikicontent caption {
text-align:center;
font-weight:700;
}

.wikicontent th,td {
border:1px solid gray;
}

.wikicontent dt,.wikicontent h1,.wikicontent h2,.wikicontent h3,.wikicontent h4,.wikicontent h5,.wikicontent h6 {
font-weight:700;
}

.wikicontent h3 {
margin-top:20px;
width:max-content;
max-width: 90%
border-radius:0 6px 6px 0;
}

.wikicontent h5 {
margin:15px 0 5px;
}

.wikicontent h6 {
margin:10px 0 5px;
}

.wikicontent blockquote {
margin-inline:40px;
border-left:4px solid gray;
margin-top:1em;
margin-bottom:1em;
padding:4px 16px;
}

[cigma]

[*]Share bug report(s) to increase votes.

Here is one of them: https://boardgamearena.com/bug?id=102754 It's not exactly about the wiki, but related to it (missleading link). Please vote for it!

[Sammy McSam]

Please vote for it!

Thanks for raising this, voted and added: https://en.doc.boardgamearena.com/Wiki_ ... #Languages

[kevan]

Thanks for the feedback. I've made HTML/CSS less prominent and regrouped by list type.

A suggested plan of action, not necessarily in this order:

1. Share bug report(s) to increase votes.
2. Test CSS workarounds and agree on a set of recommended CSS rules. | Wiki reference
3. Ask more users to test the recommended CSS rules and provide any feedback. | bga-developers discord
4. Add specific & concise issue descriptions and relevant CSS rules to existing bug reports.
5. Request the chrome extension developers use the recommended CSS rules. | Wiki reference
6. As more users install the chrome extension, BGA staff will take more interest in the CSS and hopefully fix themselves.

The CSS stuff doesn't seem like a complicated fix that needs experimentation, BGA staff just need to be made aware that they forgot to except the wikicontent elements from their bullet/heading changes for the wider site in 2020 and 2022. And the bugs for section and gamehelp links are down to how BGA generates its game page, rather than a CSS issue.

Voting the bugs up, and making people aware that these are fixable bugs rather a deliberate BGA aesthetic, seems the way to go, to me, but I'm unfamiliar with the Chrome extension. If you think that BGA staff are more likely to notice that than a bug report, fair enough.

Here's a full list of current wiki ruleset bugs, anyway, taken from the wiki page:

• Bullet points not visible (open since April 2020)
• Rule section headings overlapping the text (open since September 2022)
• Ruleset h2/h3 headings not being nested (open since April 2023)
• Section links don't work in the BGA view of wiki rules pages (open since May 2023)
• Short rules: Gamehelp link for editing is misleading (open since October 2023)

[friendofblahaj]

I found my way to this thread after searching for an answer to why bullets and headers were not appearing correctly. I figured someone must have already discussed the issue, and I was right! Thank you for the formatting reference guide as well as your advocacy for a solution.

[Meeplelowda]

I found my way to this thread after searching for an answer to why bullets and headers were not appearing correctly. I figured someone must have already discussed the issue, and I was right! Thank you for the formatting reference guide as well as your advocacy for a solution.

Thanks for making the effort to actually search first instead of just blasting off a new topic. Not all heroes wear capes.

[SimplicatusGames]

Here's a full list of current wiki ruleset bugs, anyway, taken from the wiki page:

• Bullet points not visible (open since April 2020)
• Rule section headings overlapping the text (open since September 2022)
• Ruleset h2/h3 headings not being nested (open since April 2023)
• Section links don't work in the BGA view of wiki rules pages (open since May 2023)
• Short rules: Gamehelp link for editing is misleading (open since October 2023)

Upvoted - and hereby bumped, hoping that more people will do the same.

I've been proofreading and improving the layout of many How to play wikis, adding an unknown number of bullet point characters in order to make the text more readable (most recently in the 51st State wiki). If BGA ever fixes these display bugs for the Wiki there will be a certain amount of rollback work, but it will be worth it. I just hope it happens sooner rather than later.

And now for my question - I could swear that it used to be possible to use different font colours (which is very useful when explaining about differently coloured game objects), but now I cannot see that option at all in the formatting menu in the Visual editing view. Can anybody help me with some info?

PS: I just had the idea of copying the markup code for font colours from here and see if I can add it in the [[]] Source editing view.