Welcome to 2019
[ikiwiki.git] / doc / bugs / disabling_backlinks.mdwn
1 I have tried `--numbacklinks 0` on ikiwiki commandline, but I still get backlinks.  The man page says:
2
3     --numbacklinks n
4         Controls how many backlinks should be displayed maximum. 
5         Excess backlinks will be hidden in a popup. 
6         Default is 10. Set to 0 to disable this feature.
7
8 My first reading (and second and third) of this was that backlinks would be disabled entirely if I set numbacklinks=0, but now that I look again, I see the possibility that it is just controlling how many may be displayed before moving excess to a popup. If this is in fact how it is meant, I'll just get rid of the backlinks via the page template. Is this the case, that numbacklinks controls the popup, rather than backlinks in general?
9
10 --[[KarlMW]]
11
12 > Yes, it only controls the number of backlinks that are shown at the
13 > bottom of the page vs how many are moved to the popup. I've tried to
14 > improve the documentation for this. [[done]] --[[Joey]]
15
16
17 I notice that there is quite a bit of redundancy when both tags and
18 backlinks are used extensively. On most pages, the set of links features in
19 both categories is almost identical because a tag's index page is shown
20 both as a tag link and as a backlink. Is there a way to improve that
21 situation somehow? I realise that backlinks aren't generated when the tag
22 index page refers to its contents by \[\[!map ...]], etc., but sometimes an
23 auto-generated index is insufficient.
24
25  --Peter
26
27 > Um, if you're manually linking from the tag's page to each page so
28 > tagged, I think you have larger problems than tags and backlinks being
29 > the same. Like keeping that list of links up to date as tags are added
30 > and changed. --[[Joey]]
31
32 I see your point, Joey. I need to maintain that list manually, though, because the automatically generated list is too brief. \[[!map ...]] generates just a list of titles or descriptions. I need a list that contains both. See [[this_posting|ikiwiki/directive/map/discussion]] for more details. Until \[[!map]] can do that, I'm stuck with a manually maintained list. Which means that every link shows up in the backlinks.