DocFX Ausgabe nach Markdown

Question

Blick auf den Fluss DocFX scheint zu erstellen. Md-Dateien und dann konvertieren diese in HTML beim Erstellen von Dokumentation.

Gibt es eine Möglichkeit, DocFX in .md-Dateien anstelle von HTML ausgeben zu lassen?

Answer 1

Sie sollten die .md-Dateien von content zu resource in docfx.json verschieben.

Nehmen Sie als Beispiel die Folgenummer docfx.json Snippet. Alle .md Dateien in articles werden in .html in der Ausgabe konvertiert.

... 
"build": { 
    "content": [ 
    { 
     "files": ["articles/**.md"] 
    } 
    ] 
} 
... 

Wenn Sie articles/sample.md bleibt nicht umgesetztes hoffen, können Sie docfx.json wie unten ändern:

... 
"build": { 
    "content": [ 
    { 
     "files": ["articles/**.md"], 
     "exclude": ["articles/sample.md"] 
    } 
    ] 
    "resource": [ 
    { 
     "files": ["articles/sample.md"] 
    } 
    ] 
} 
... 

Weitere Informationen finden Sie auf DocFX User Manual finden.