Enable Version Switching about ardusub-zola HOT 5 OPEN

While branches for companion, ardusub, and qgroundcontrol are a given/requirement, it may also be worth having a branch that allows selecting Python version for the pymavlink examples.

from ardusub-zola.

Need to add a macro to the header of versioned sections/pages that does something along the lines of

<script>
  function change_version() {
    ... // modify url by replacing version number
  } 
</script>

<select name="versions" id="versions" onChange="change_version()">
  {% for version in versions %}
    <option value={{ version }}>{{ version.title }}</option>
  {% endfor %}
</select>

• versions needs to be determined in a way that allows nested pages to still change versions (e.g. software/companion/1.0/configuration/... should be able to go to software/companion/1.0.1/configuration/...) - perhaps check path parent until a non-versioned parent section of the current versioned section is found
• should have an intelligent fallback if an equivalent page doesn't exist (e.g. go to root of version)
• searching is tricky - would be ideal to have options for general searching over the full docs (preferentially indexed to the latest version of each software, somehow), and another option for searching specifically within the selected version of the current software docs (based on the current page)
• @patrickelectric has suggested it may be possible to do the change_version page-changing functionality using just Zola constructs/functions rather than using javascript

from ardusub-zola.

May be relevant to consider Rust's version selector:

from ardusub-zola.

While branches for companion, ardusub, and qgroundcontrol are a given/requirement, it may also be worth having a branch that allows selecting Python version for the pymavlink examples.

If we really need different python versions, I would use tabs on the code visualizer.

from ardusub-zola.

If we really need different python versions, I would use tabs on the code visualizer.

No idea if that's possible, but it does seem like a nice way of handling it, particularly given it's a different kind of version than the others (version of underlying technology, rather than version of the software/library itself).

from ardusub-zola.