Skip to content

Commit d3b8ecd

Browse files
alandefreitasalandefreitas
committed
fix: hide anchor links when wrapper is not included
1 parent c85be75 commit d3b8ecd

File tree

228 files changed

+2440
-4851
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

228 files changed

+2440
-4851
lines changed

‎share/mrdocs/addons/generator/html/layouts/wrapper.html.hbs‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,11 @@
4949
{{#if page.hasDefaultStyles}}
5050
<script>
5151
(function(){
52+
// Enable anchor visibility (hidden by default for graceful degradation)
53+
document.querySelectorAll("a.mrdocs-anchor").forEach(function(el){
54+
el.style.visibility = "visible";
55+
});
56+
// Copy permalink URL to clipboard on anchor click
5257
document.addEventListener("click", function(e){
5358
var anchor = e.target.closest && e.target.closest("a.mrdocs-anchor");
5459
if (!anchor) return;

‎share/mrdocs/addons/generator/html/partials/markup/h.html.hbs‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,10 @@
11
<h{{or level 3}}{{#if class}} class="{{{class}}}"{{/if}}{{#if id}} id="{{{id}}}"{{/if}}>
22
{{> @partial-block }}
33
{{#if id}}
4-
<a class="mrdocs-anchor" href="#{{id}}" aria-label="Permalink">#</a>
4+
{{#if @root.config.multipage}}
5+
{{#unless @root.config.embedded}}
6+
<a class="mrdocs-anchor" style="visibility:hidden" href="#{{id}}" aria-label="Permalink">#</a>
7+
{{/unless}}
8+
{{/if}}
59
{{/if}}
610
</h{{or level 3}}>

‎test-files/golden-tests/config/auto-brief/auto-brief.html‎

Lines changed: 32 additions & 64 deletions
Original file line numberDiff line numberDiff line change
@@ -9,8 +9,7 @@ <h1>Reference</h1>
99
<div>
1010
<div>
1111
<h2 id="index">
12-
Global Namespace<a class="mrdocs-anchor" href="#index" aria-label="Permalink">#</a>
13-
</h2>
12+
Global Namespace</h2>
1413
</div>
1514
<h2>
1615
Functions</h2>
@@ -60,8 +59,7 @@ <h2>
6059
<div>
6160
<div>
6261
<h2 id="copyBriefFromCopyBrief">
63-
copyBriefFromCopyBrief<a class="mrdocs-anchor" href="#copyBriefFromCopyBrief" aria-label="Permalink">#</a>
64-
</h2>
62+
copyBriefFromCopyBrief</h2>
6563
<div>
6664
<p>This is the explicit brief.</p>
6765
</div>
@@ -78,8 +76,7 @@ <h3>
7876
<div>
7977
<div>
8078
<h2 id="copyBriefFromExplicitBrief">
81-
copyBriefFromExplicitBrief<a class="mrdocs-anchor" href="#copyBriefFromExplicitBrief" aria-label="Permalink">#</a>
82-
</h2>
79+
copyBriefFromExplicitBrief</h2>
8380
<div>
8481
<p>This is the explicit brief.</p>
8582
</div>
@@ -96,8 +93,7 @@ <h3>
9693
<div>
9794
<div>
9895
<h2 id="copyBriefFromFirstSentenceAsBrief">
99-
copyBriefFromFirstSentenceAsBrief<a class="mrdocs-anchor" href="#copyBriefFromFirstSentenceAsBrief" aria-label="Permalink">#</a>
100-
</h2>
96+
copyBriefFromFirstSentenceAsBrief</h2>
10197
<div>
10298
<p>This is the brief.</p>
10399
</div>
@@ -114,8 +110,7 @@ <h3>
114110
<div>
115111
<div>
116112
<h2 id="copyBriefFromFirstValid">
117-
copyBriefFromFirstValid<a class="mrdocs-anchor" href="#copyBriefFromFirstValid" aria-label="Permalink">#</a>
118-
</h2>
113+
copyBriefFromFirstValid</h2>
119114
<div>
120115
<p>This function has documentation but no brief.</p>
121116
</div>
@@ -132,8 +127,7 @@ <h3>
132127
<div>
133128
<div>
134129
<h2 id="copyDetailsFromCopyBrief">
135-
copyDetailsFromCopyBrief<a class="mrdocs-anchor" href="#copyDetailsFromCopyBrief" aria-label="Permalink">#</a>
136-
</h2>
130+
copyDetailsFromCopyBrief</h2>
137131
<div>
138132
<p>Details will be copied</p>
139133
</div>
@@ -150,8 +144,7 @@ <h3>
150144
<div>
151145
<div>
152146
<h2 id="copyDetailsFromDocNoBrief">
153-
copyDetailsFromDocNoBrief<a class="mrdocs-anchor" href="#copyDetailsFromDocNoBrief" aria-label="Permalink">#</a>
154-
</h2>
147+
copyDetailsFromDocNoBrief</h2>
155148
<div>
156149
<p>Custom brief</p>
157150
</div>
@@ -168,8 +161,7 @@ <h3>
168161
<div>
169162
<div>
170163
<h2 id="copyDetailsFromExplicitBrief">
171-
copyDetailsFromExplicitBrief<a class="mrdocs-anchor" href="#copyDetailsFromExplicitBrief" aria-label="Permalink">#</a>
172-
</h2>
164+
copyDetailsFromExplicitBrief</h2>
173165
</div>
174166
<div>
175167
<h3>
@@ -188,8 +180,7 @@ <h3>
188180
<div>
189181
<div>
190182
<h2 id="copyDetailsFromFirstSentenceAsBrief">
191-
copyDetailsFromFirstSentenceAsBrief<a class="mrdocs-anchor" href="#copyDetailsFromFirstSentenceAsBrief" aria-label="Permalink">#</a>
192-
</h2>
183+
copyDetailsFromFirstSentenceAsBrief</h2>
193184
</div>
194185
<div>
195186
<h3>
@@ -208,8 +199,7 @@ <h3>
208199
<div>
209200
<div>
210201
<h2 id="copyDetailsFromNoDoc">
211-
copyDetailsFromNoDoc<a class="mrdocs-anchor" href="#copyDetailsFromNoDoc" aria-label="Permalink">#</a>
212-
</h2>
202+
copyDetailsFromNoDoc</h2>
213203
<div>
214204
<p>Custom brief</p>
215205
</div>
@@ -226,8 +216,7 @@ <h3>
226216
<div>
227217
<div>
228218
<h2 id="copyDocFromCopyBrief">
229-
copyDocFromCopyBrief<a class="mrdocs-anchor" href="#copyDocFromCopyBrief" aria-label="Permalink">#</a>
230-
</h2>
219+
copyDocFromCopyBrief</h2>
231220
<div>
232221
<p>This is the explicit brief.</p>
233222
</div>
@@ -249,8 +238,7 @@ <h3>
249238
<div>
250239
<div>
251240
<h2 id="copyDocFromExplicitBrief">
252-
copyDocFromExplicitBrief<a class="mrdocs-anchor" href="#copyDocFromExplicitBrief" aria-label="Permalink">#</a>
253-
</h2>
241+
copyDocFromExplicitBrief</h2>
254242
<div>
255243
<p>This is the explicit brief.</p>
256244
</div>
@@ -272,8 +260,7 @@ <h3>
272260
<div>
273261
<div>
274262
<h2 id="copyDocFromFirstSentenceAsBrief">
275-
copyDocFromFirstSentenceAsBrief<a class="mrdocs-anchor" href="#copyDocFromFirstSentenceAsBrief" aria-label="Permalink">#</a>
276-
</h2>
263+
copyDocFromFirstSentenceAsBrief</h2>
277264
<div>
278265
<p>This is the brief.</p>
279266
</div>
@@ -295,8 +282,7 @@ <h3>
295282
<div>
296283
<div>
297284
<h2 id="docNoBriefFunction">
298-
docNoBriefFunction<a class="mrdocs-anchor" href="#docNoBriefFunction" aria-label="Permalink">#</a>
299-
</h2>
285+
docNoBriefFunction</h2>
300286
<div>
301287
<p>This function has documentation but no brief.</p>
302288
</div>
@@ -313,8 +299,7 @@ <h3>
313299
<div>
314300
<div>
315301
<h2 id="explicitBriefFunction">
316-
explicitBriefFunction<a class="mrdocs-anchor" href="#explicitBriefFunction" aria-label="Permalink">#</a>
317-
</h2>
302+
explicitBriefFunction</h2>
318303
<div>
319304
<p>This is the explicit brief.</p>
320305
</div>
@@ -336,8 +321,7 @@ <h3>
336321
<div>
337322
<div>
338323
<h2 id="explicitBriefFunction2">
339-
explicitBriefFunction2<a class="mrdocs-anchor" href="#explicitBriefFunction2" aria-label="Permalink">#</a>
340-
</h2>
324+
explicitBriefFunction2</h2>
341325
<div>
342326
<p>This is the explicit brief.</p>
343327
</div>
@@ -359,8 +343,7 @@ <h3>
359343
<div>
360344
<div>
361345
<h2 id="failCircularReferenceCopyFunction">
362-
failCircularReferenceCopyFunction<a class="mrdocs-anchor" href="#failCircularReferenceCopyFunction" aria-label="Permalink">#</a>
363-
</h2>
346+
failCircularReferenceCopyFunction</h2>
364347
</div>
365348
<div>
366349
<h3>
@@ -374,8 +357,7 @@ <h3>
374357
<div>
375358
<div>
376359
<h2 id="failCircularSourceFunctionA">
377-
failCircularSourceFunctionA<a class="mrdocs-anchor" href="#failCircularSourceFunctionA" aria-label="Permalink">#</a>
378-
</h2>
360+
failCircularSourceFunctionA</h2>
379361
</div>
380362
<div>
381363
<h3>
@@ -389,8 +371,7 @@ <h3>
389371
<div>
390372
<div>
391373
<h2 id="failCircularSourceFunctionB">
392-
failCircularSourceFunctionB<a class="mrdocs-anchor" href="#failCircularSourceFunctionB" aria-label="Permalink">#</a>
393-
</h2>
374+
failCircularSourceFunctionB</h2>
394375
</div>
395376
<div>
396377
<h3>
@@ -404,8 +385,7 @@ <h3>
404385
<div>
405386
<div>
406387
<h2 id="failCopyBriefFromDocNoBrief">
407-
failCopyBriefFromDocNoBrief<a class="mrdocs-anchor" href="#failCopyBriefFromDocNoBrief" aria-label="Permalink">#</a>
408-
</h2>
388+
failCopyBriefFromDocNoBrief</h2>
409389
<div>
410390
<p>This function has documentation but no brief.</p>
411391
</div>
@@ -422,8 +402,7 @@ <h3>
422402
<div>
423403
<div>
424404
<h2 id="failCopyBriefFromInvalidReference">
425-
failCopyBriefFromInvalidReference<a class="mrdocs-anchor" href="#failCopyBriefFromInvalidReference" aria-label="Permalink">#</a>
426-
</h2>
405+
failCopyBriefFromInvalidReference</h2>
427406
</div>
428407
<div>
429408
<h3>
@@ -437,8 +416,7 @@ <h3>
437416
<div>
438417
<div>
439418
<h2 id="failCopyBriefFromNoDoc">
440-
failCopyBriefFromNoDoc<a class="mrdocs-anchor" href="#failCopyBriefFromNoDoc" aria-label="Permalink">#</a>
441-
</h2>
419+
failCopyBriefFromNoDoc</h2>
442420
</div>
443421
<div>
444422
<h3>
@@ -452,8 +430,7 @@ <h3>
452430
<div>
453431
<div>
454432
<h2 id="failCopyDetailsFromInvalidReference">
455-
failCopyDetailsFromInvalidReference<a class="mrdocs-anchor" href="#failCopyDetailsFromInvalidReference" aria-label="Permalink">#</a>
456-
</h2>
433+
failCopyDetailsFromInvalidReference</h2>
457434
</div>
458435
<div>
459436
<h3>
@@ -467,8 +444,7 @@ <h3>
467444
<div>
468445
<div>
469446
<h2 id="failCopyDocFromDocNoBrief">
470-
failCopyDocFromDocNoBrief<a class="mrdocs-anchor" href="#failCopyDocFromDocNoBrief" aria-label="Permalink">#</a>
471-
</h2>
447+
failCopyDocFromDocNoBrief</h2>
472448
<div>
473449
<p>This function has documentation but no brief.</p>
474450
</div>
@@ -485,8 +461,7 @@ <h3>
485461
<div>
486462
<div>
487463
<h2 id="failCopyDocFromInvalidReference">
488-
failCopyDocFromInvalidReference<a class="mrdocs-anchor" href="#failCopyDocFromInvalidReference" aria-label="Permalink">#</a>
489-
</h2>
464+
failCopyDocFromInvalidReference</h2>
490465
</div>
491466
<div>
492467
<h3>
@@ -500,8 +475,7 @@ <h3>
500475
<div>
501476
<div>
502477
<h2 id="failCopyDocFromNoDoc">
503-
failCopyDocFromNoDoc<a class="mrdocs-anchor" href="#failCopyDocFromNoDoc" aria-label="Permalink">#</a>
504-
</h2>
478+
failCopyDocFromNoDoc</h2>
505479
</div>
506480
<div>
507481
<h3>
@@ -515,8 +489,7 @@ <h3>
515489
<div>
516490
<div>
517491
<h2 id="failInvalidReferenceCopyFunctions">
518-
failInvalidReferenceCopyFunctions<a class="mrdocs-anchor" href="#failInvalidReferenceCopyFunctions" aria-label="Permalink">#</a>
519-
</h2>
492+
failInvalidReferenceCopyFunctions</h2>
520493
</div>
521494
<div>
522495
<h3>
@@ -530,8 +503,7 @@ <h3>
530503
<div>
531504
<div>
532505
<h2 id="firstSentenceAsBriefFunction">
533-
firstSentenceAsBriefFunction<a class="mrdocs-anchor" href="#firstSentenceAsBriefFunction" aria-label="Permalink">#</a>
534-
</h2>
506+
firstSentenceAsBriefFunction</h2>
535507
<div>
536508
<p>This is the brief.</p>
537509
</div>
@@ -553,8 +525,7 @@ <h3>
553525
<div>
554526
<div>
555527
<h2 id="noDocFunction">
556-
noDocFunction<a class="mrdocs-anchor" href="#noDocFunction" aria-label="Permalink">#</a>
557-
</h2>
528+
noDocFunction</h2>
558529
</div>
559530
<div>
560531
<h3>
@@ -568,8 +539,7 @@ <h3>
568539
<div>
569540
<div>
570541
<h2 id="recursiveReferenceCopyFunction">
571-
recursiveReferenceCopyFunction<a class="mrdocs-anchor" href="#recursiveReferenceCopyFunction" aria-label="Permalink">#</a>
572-
</h2>
542+
recursiveReferenceCopyFunction</h2>
573543
<div>
574544
<p>Final recursive brief</p>
575545
</div>
@@ -586,8 +556,7 @@ <h3>
586556
<div>
587557
<div>
588558
<h2 id="recursiveSourceFunctionA">
589-
recursiveSourceFunctionA<a class="mrdocs-anchor" href="#recursiveSourceFunctionA" aria-label="Permalink">#</a>
590-
</h2>
559+
recursiveSourceFunctionA</h2>
591560
<div>
592561
<p>Final recursive brief</p>
593562
</div>
@@ -604,8 +573,7 @@ <h3>
604573
<div>
605574
<div>
606575
<h2 id="recursiveSourceFunctionB">
607-
recursiveSourceFunctionB<a class="mrdocs-anchor" href="#recursiveSourceFunctionB" aria-label="Permalink">#</a>
608-
</h2>
576+
recursiveSourceFunctionB</h2>
609577
<div>
610578
<p>Final recursive brief</p>
611579
</div>

0 commit comments

Comments
 (0)