Skip to content
Snippets Groups Projects
  1. Aug 13, 2020
  2. Aug 11, 2020
    • PLanCompS's avatar
      Update navigation-structure.md · cff0254d
      PLanCompS authored
      Adjusted the documentation to explain how mixtures of numbers and strings are treated by `nav_order`.
      cff0254d
    • PLanCompS's avatar
      Separate sorting of numbers and strings for navigation order · 4fc59a57
      PLanCompS authored
      The values of `title` and `nav_order` can be numbers or strings.
      Jekyll gives build failures when sorting on mixtures of different types,
      so numbers and strings need to be sorted separately.
      
      Here, numbers are sorted by their values, and come before all strings.
      An omitted `nav_order` value is equivalent to the page's `title` value
      (except that a numerical `title` value is treated as a string).
      
      The case-sensitivity of string sorting is determined by `site.nav_sort`.
      4fc59a57
  3. Aug 10, 2020
    • PLanCompS's avatar
      Ensure pages with nav_exclude are ignored by navigation · 83ec5533
      PLanCompS authored
      Pages with `nav_exclude: true` were included when sorting on `title` or `nav_order`. That could cause build failures when the type of value of the field differs from that on other pages, as reported in https://github.com/pmarsceill/just-the-docs/issues/406.
      
      Pages with `nav_exclude: true` or no `title` are never displayed in the navigation, so removing them from `pages_list` cannot break existing sites. This change also allows the removal of some tests in the code. (The indentation of the code should now be adjusted, but that has been deferred, to restrict the size of the diff for review.)
      
      For testing, the title of `404.html` has been changed to the number `404`,  the page `docs/untitled-test.md`  has been added, and `nav_sort_order` has been set to `case_sensitive`. Those updates give build failures with the current version of `_includes/nav.html`, but not after the suggested changes.
      
      It will still be possible for build failures to occur due to sorting fields of *non-excluded* pages with differing types of values (e.g., `nav_order`a mixture of numbers and strings). To make the code completely safe will require relatively complicated changes,.
      83ec5533
  4. Jun 30, 2020
  5. Jun 25, 2020
  6. Jun 18, 2020
  7. May 05, 2020
  8. May 02, 2020
    • PLanCompS's avatar
      Update documentation with collapsible TOC · e40ba9c6
      PLanCompS authored
      Makes the TOC at the top of the page collapsible.
      Adds an explanation of the markup used to produce a collapsible TOC.
      Adds a comment about the possibility of using an unordered list for the TOC,
      and about using TOC only once per page.
      e40ba9c6
  9. May 01, 2020
  10. Apr 28, 2020
  11. Apr 25, 2020
    • PLanCompS's avatar
      Made case-insenstive sorting the default · c46ccd34
      PLanCompS authored
      Added a configuration option to determine whether the sort order is case-sensitive.
      The default is case-insensitive.
      
      To test:
      - open `/just-the-docs/docs/utilities/` in the browser,
        and check that the navigation links in `Utilities` are sorted alphabetically;
      - in `docs/utilities/layout.md', change the preamble to `title: layout`,
        and check that the  links in `Utilities` are still sorted alphabetically;
      - add `nav_sort: case_sensitive` in the configuration file,
        and check that the link to `layout` is now listed last under `Utilities`.
      c46ccd34
  12. Apr 24, 2020
  13. Mar 24, 2020
  14. Jan 12, 2020
  15. Jan 02, 2020
  16. Dec 29, 2019
  17. Nov 27, 2019
  18. Nov 12, 2019
    • Alexey Averikhin's avatar
      Enable IP anonymization in Google Analytics (GDPR) · 25331a5f
      Alexey Averikhin authored
      - Introduced "ga_tracking_anonymize_ip" parameter to enable/disable Google Analytics IP anonymization (to comply with GDPR).
      
      (cherry picked from commit ce530f36fa0549c78ffe53ea6077f44f6f0b330f) (+1 squashed commit)
      Squashed commits:
      [69b7718] - enable GA anonymize_ip
      
      (cherry picked from commit f2b67c632af72b61dd634b9a337200781519691e)
      25331a5f
  19. Oct 11, 2019
  20. Oct 02, 2019
  21. Sep 11, 2019
  22. Sep 10, 2019
  23. Sep 09, 2019
  24. Sep 04, 2019
  25. Aug 31, 2019
Loading