Link to learn site for examples

For now directly to the yaml, later to the html page

Author: ralfhandl

scripts/md2html/md2html.js

@@ -270,12 +270,16 @@ for (let l in lines) {
     }
 
     // fix relative links (to examples)
-    //TODO: adjust when moving examples to a different repo
-    if (!inCodeBlock && line.indexOf('](../') >= 0) {
+    if (!inCodeBlock && line.indexOf('](../examples/') >= 0) {
+        line = line.replace(/\(\.\.\/examples\/([^)]+)\)/g,function(match,group1){
+            //TODO: group1 = group1.replace('.yaml','.html');
+            return `(https://learn.openapis.org/examples/${group1})`;
+          })
+    } else if (!inCodeBlock && line.indexOf('](../') >= 0) {
         const regExp = /\((\.\.[^)]+)\)/g;
         line = line.replace(regExp,function(match,group1){
           console.warn('Fixing relative link',group1,line);
-          return '('+url.resolve('https://github.com/OAI/OpenAPI-Specification/tree/master/versions/foo',group1)+')';
+          return '('+url.resolve('https://github.com/OAI/OpenAPI-Specification/tree/main/versions/foo',group1)+')';
         });
     }
 

tests/md2html/fixtures/basic-new.html

@@ -10,7 +10,8 @@
 <p>Definition of Foo.</p>
 </section></section><section><h1>Another Heading 2</h1>
 <p>Text for second section</p>
-<p><a href="https://github.com/OAI/OpenAPI-Specification/tree/master/examples/foo.yaml">Relative link</a></p>
+<p><a href="https://learn.openapis.org/examples/foo.yaml">Relative link to example</a></p>
+<p><a href="https://github.com/OAI/OpenAPI-Specification/tree/main/something/else">Relative link to something else</a></p>
 <section><h2>Heading 3</h2>
 <p>Text for first subsection</p>
 <p>[[RFC3986]]</p>

tests/md2html/fixtures/basic-new.md

@@ -20,7 +20,9 @@ Definition of Foo.
 
 Text for second section
 
-[Relative link](../examples/foo.yaml)
+[Relative link to example](../examples/foo.yaml)
+
+[Relative link to something else](../something/else)
 
 ### Heading 3