firstwiki / firstwiki.github.io Goto Github PK

I don't have any good ideas for this yet, but at some point it would be nice to have images included too -- but I also don't want to have to worry about github's potential repository size limits.

Suggestions welcome!

To retain the good things about being a wiki, most importantly, the easy access to information, I think a search function. It can be a simple as using the google site: tag in a google search, but it needs something, rather than forcing users to go hunting through menus and categories.

• How to edit content
• Example pages
• Etc

If you do something like this in kramdown...

1. TOC
{:toc}

It will render a table of contents, with a default ID of 'markdown-toc'. Unfortunately, you end up with a numbered list, but it doesn't sub-number the list (2.2, 2.3 ... )like Wikpedia does, nor does it give it that nice 'Content' header either.

The kramdown option can be put in an include called 'toc', so you'll just have to do

{% include toc %}

on each and every page. It doesn't appear that you can add that to a layout.

Otherwise, we could add a nice javascript module that autocalculates a TOC and puts it on the page somewhere. Given our extensive use of javascript elsewhere, and the fact that we can really extend this, it's probably the best choice... but I'll have to think about this, there are merits on both sides.

Others are welcome to weigh in on this.

https://jekyllrb.com/docs/continuous-integration/

I've placed a dump of formatted data at https://github.com/firstwiki/original_archive, just need to take the time to go through it and add it to where it belongs.

Various sources:

• https://github.com/flamingchickens1540/frc-software-releases
• ChiefDelphi

Like the way that read the docs does it. Should be easy enough.

I'm thinking that we should create a JSON schema (or is there such a thing as a YAML schema?) and validate it against that... people keep messing it up and there's nothing telling them that they're doing it incorrectly.

For now, just look at team 1418 and 2423's entries.

The original FIRSTwiki had a logo derived from the wikipedia logo and the FIRST logo, but I suspect that FIRST's branding policies do not actually allow people to create derived logos in that fashion.