Just symlink all index.md -> README.md

Another route would be to set in conf.py

  root_doc = 'README'

Which works, except that then all URLs will have README.html in them;
it would work if we could configure the webserver hosting us
to treat README.html as an index page, which we can do if we self-host,
but that's probably not possible with most, and above all it's not
a very portable solution. So instead: symlinks.

Maybe there's a configuration option that can rewrite README -> index
during the build. But that'll probably mess up something else somewhere.

These were created with

find . -name "README.md" |
  while read target; do
    (
      cd $(dirname $target);
      ln -sf README.md index.md
    );
  done

They should only show in the sidebar.

i.e. when clicking links on the secondary :contents: navbar.

This is a temporary measure, for demoing.

The old way meant:
- clicking Edit On Github on an index page would go to a page that just said README.md
- toctree's :glob: feature would get into an infinite loop if I use *; it's smart enough not to recurse into the
  calling page, but not to recurse into the symlinked copy of the calling page and then back again...

Not that we actually use the _sources feature.

This means it's real easy to add yourself as a new member: just create a page.

Gitbook's {% embed %} tag calls out to iframe.ly which calls out to
slideshare.net. Just get the slideshare embed code directly.

Firefox and Chrome both, finally, after years, have good working
native PDF <embed> support.

I even managed to get the boxes sized to fit 16:9 or 4:3 aspect PDFs.

I broke it in "Widen page to ensure navbar is always flush to the left."
by expanding the main content but not matching the topbar to it.

This is more our internal calendar, and should probably be on neuropoly-internal-docs.
Do we have a better public-facing option?

"Follow Us On" was a non-sequitur on the events page.

Move "Follow Us On" next to the front page Twitter icon.

It turns out I'd misread some things. I thought you were supposed to put
embeds inside objects, but actually objects supersede embeds.
See https://developer.mozilla.org/en-US/docs/Learn/HTML/Multimedia_and_embedding/Other_embedding_technologies#the_embed_and_object_elements

This reverts commit f5f59dd.

The secondary sidebar on /team/README.html is enough.

See executablebooks/sphinx-book-theme#425

Several people gave feedback that it was confusing having the empty pages these left.
I also unhid the not-quite-empty research/ page, since it's /basically/ empty anyway.

And make them iconified (on visual browsers, but still readable on
screenreaders/lynx)

…ghlight our top-level pages

This site isn't "docs", so "Search the docs" makes no sense.

…se to highlight our top-level pages"

This reverts commit 02daeff.

This is a stupid way to do it but it preserves the #anchor links
which seems more important.

Personally, I would like to merge intranet.neuro into this wiki, and make this a relative link.

Lists have an easier syntax, especially since we only have one
column in these tables.

Maybe we'll have multiple columns again in the future,
but I think at that point I will be scraping Github profiles
to *generate* the content, and so prettiness will be irrelevant.
But for now it is relevant.

This makes the syntax easier to work with, but doesn't change
the rendered layout.

These icons are used in the Github Button and on /software.html;
this just makes everything consistent.

This migration was done with these ridiculous perl one-liners:

perl -i -pe 's/\[\!\[(.*?)\].*\((https:.*)\)/[<i class="fab fa-\L\1\E" title="\1" aria-hidden="true"><\/i><span>\1<\/span>]\(\2)/' team/README.md &&
perl -i -pe 's/\[\!\[(E-Mail)\].*\((mailto:.*)\)/[<i class="fa fa-envelope" title="\1" aria-hidden="true"><\/i><span>\1<\/span>]\(\2)/' team/README.md

Just repeating the embed URL is what https://executablebooks.org/en/latest/meetings/index.html?highlight=calendar
does, but that's pretty pointless: you still have to click the "+ Google Calendar"
button in the corner on that page ...which is already visible in the
embedded calendar.

Now there's one link that prompts you to subscribe, if you're logged in
to Google, and one that works with every other apps (because it's .ics)

Something is wrong with sphinx-book-theme in a way that broke
when sphinx went from 4.2.0 to 4.3.0 this week.

This doesn't actually do anything here right now,
but was discovered in
https://github.com/neuropoly/neuropoly-internal-docs/, which has
sphinx-panels enabled. If we enable sphinx-panels here too,
we'll need the same patch.