FYI: Issues with Docnav variations

[Roy_043]

In the past few days I have noticed several Docnav variations.

1. This is the default use and works OK:

Code: Select all

{{Docnav
|[[Import_Export_Preference|Import Export Preference]]
|[[Property_editor|Property editor]]
}}

2. I have also seen this:

Code: Select all

{{Docnav|Import Export Preference|Property editor}}

Also works. But interestingly 'previous' or 'next' are now part of the link.


3. And I have seen this:

Code: Select all

{{Docnav
|Import Export Preference
|Property editor
}}

This does not work. The template cannot handle this formatting.

[vocx]

In the past few days I have noticed several Docnav variations.
...

I think this was developed by mario52.

I personally don't like the template because it works in a linear fashion. Most pages in a wiki aren't meant to be read linearly, you need to be able to jump around the different topics. And of course, if you add a new page "between" two other pages, then it gets out of order quickly. This is bound to happen because FreeCAD is still under heavy development, including the documentation.

In my opinion, this template only makes sense in a linear manual. But most other pages in the wiki don't need it.

[Roy_043]

I personally don't like

The goal of this topic is more practical in nature:
Maybe the template should be fixed so that all 3 variations result in the same HTML?
And in the meantime variation #3 should not be used as it messes up the layout.

[vocx]

Maybe the template should be fixed so that all 3 variations result in the same HTML?

There is a million different ways you can use this template. See its code in https://wiki.freecadweb.org/Template:Docnav

I don't feel like spending time fixing any problems with this template. Ask mario.

[Roy_043]

I see that the faulty variation #3 is actually the first example on the linked page. Something must have broken.

Ping

[mario52]

hi

the example in the template page work well !!

Code: Select all

{{Docnav
|Draft Workbench 
|Arch Workbench 
}}

he is preferable to use this model ([[Import_Export_Preference|Import Export Preference]]) many easy for the translator

1. This is the default use and works OK:

Code : Tout sélectionner

{{Docnav
|[[Import_Export_Preference|Import Export Preference]]
|[[Property_editor|Property editor]]
}}

_________________________________________________________________________________________________________________

certain new translator make this (example)

Code: Select all

{{Docnav/fr
|Draft Workbench/fr 
|Arch Workbench/fr 
}}

instead

Code: Select all

{{Docnav/fr
|[[Draft Workbench/fr|atelier Draft]]
|[[Arch Workbench/fr|atelier Arch]] 
}}

please the link to the page you work for see...

mario

[Roy_043]

Issue #3:
This is what I found:
https://wiki.freecadweb.org/index.php?t ... did=671417

[Roy_043]

Issue #2:
Compare:
https://wiki.freecadweb.org/Introduction_to_Python (next/previous not part of link).
https://wiki.freecadweb.org/Scripted_objects (next/previous part of link).

[mario52]

hi

i modify the documentation to adapt the vertical docnav

mario

[Roy_043]

OK, thanks.