In short, I temporarily solved the issue of creating a Markdown book in .html format using f# (Dcsdocs)

You need to build book it with
dotnet fsdocs build --input .\docs\fsharp\ --output F:\fsharp_2\ --parameters root "../"

In the F:\fsharp\ folder itself, you only need to edit the root .html files—remove the root value there.
That is, replace ../ with empty space.

Was:

<!DOCTYPE html>
<html lang="en" data-root="../">
<head>
    <meta charset="UTF-8">
    <meta content="IE=edge" http-equiv="X-UA-Compatible">
    <meta content="width=device-width, initial-scale=1.0" name="viewport">
    <meta content="" name="author">
    <!-- Opengraph properties (https://ogp.me/) -->
    <meta property="og:site_name" content="microsoft_fsharp_md">
    <meta property="og:title" content="Tour of F#" />
    <meta property="og:url" content="../tour.html">
    <meta property="og:type" content="website" />
    <!-- Twitter cards (https://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/summary-card-with-large-image) -->
    <meta name="twitter:card" content="summary_large_image">
    <meta name="twitter:site" content="../">
    <meta name="twitter:title" content="Tour of F#">
    <meta name="description" content="Examine some of the key features of the F# programming language in this tour with code samples.">
<meta name="twitter:site" content="Examine some of the key features of the F# programming language in this tour with code samples.">
<meta name="og:description" content="Examine some of the key features of the F# programming language in this tour with code samples.">
    <title>Tour of F# | microsoft_fsharp_md</title>
    <link href="https://fonts.googleapis.com" rel="preconnect">
    <link crossorigin href="https://fonts.gstatic.com" rel="preconnect">
    <link href="https://fonts.googleapis.com/css2?family=Fira+Code&display=swap" rel="stylesheet">
    <script src="https://code.iconify.design/iconify-icon/1.0.7/iconify-icon.min.js"></script>
    <link href="../img/favicon.ico" rel="icon" sizes="32x32" type="image/png"/>
    <script type="application/javascript" src="../content/fsdocs-theme-set-dark.js"></script>
    <link href="../content/fsdocs-default.css" rel="stylesheet" type="text/css"/>
    <link href="../content/fsdocs-theme.css" rel="stylesheet" type="text/css"/>

became

<!DOCTYPE html>
<html lang="en" data-root="">
<head>
    <meta charset="UTF-8">
    <meta content="IE=edge" http-equiv="X-UA-Compatible">
    <meta content="width=device-width, initial-scale=1.0" name="viewport">
    <meta content="" name="author">
    <!-- Opengraph properties (https://ogp.me/) -->
    <meta property="og:site_name" content="microsoft_fsharp_md">
    <meta property="og:title" content="Tour of F#" />
    <meta property="og:url" content="tour.html">
    <meta property="og:type" content="website" />
    <!-- Twitter cards (https://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/summary-card-with-large-image) -->
    <meta name="twitter:card" content="summary_large_image">
    <meta name="twitter:site" content="">
    <meta name="twitter:title" content="Tour of F#">
    <meta name="description" content="Examine some of the key features of the F# programming language in this tour with code samples.">
<meta name="twitter:site" content="Examine some of the key features of the F# programming language in this tour with code samples.">
<meta name="og:description" content="Examine some of the key features of the F# programming language in this tour with code samples.">
    <title>Tour of F# | microsoft_fsharp_md</title>
    <link href="https://fonts.googleapis.com" rel="preconnect">
    <link crossorigin href="https://fonts.gstatic.com" rel="preconnect">
    <link href="https://fonts.googleapis.com/css2?family=Fira+Code&display=swap" rel="stylesheet">
    <script src="https://code.iconify.design/iconify-icon/1.0.7/iconify-icon.min.js"></script>
    <link href="img/favicon.ico" rel="icon" sizes="32x32" type="image/png"/>
    <script type="application/javascript" src="content/fsdocs-theme-set-dark.js"></script>
    <link href="content/fsdocs-default.css" rel="stylesheet" type="text/css"/>
    <link href="content/fsdocs-theme.css" rel="stylesheet" type="text/css"/>

The only problem is that second and more level subfolders (third,four...) don't open correctly.
F:\fsharp_2\language-reference\exception-handling

To do this, you need to add the root path twice:
for the second-level file:
F:\fsharp_2\language-reference\functions\do-bindings.html

Before:

    <link href="../img/favicon.ico" rel="icon" sizes="32x32" type="../image/png"/>
    <script type="application/javascript" src="../content/fsdocs-theme-set-dark.js"></script>
    <link href="../content/fsdocs-default.css" rel="stylesheet" type="text/css"/>
    <link href="../content/fsdocs-theme.css" rel="stylesheet" type="text/css"/>

After

<link href="../../img/favicon.ico" rel="icon" sizes="32x32" type="../../image/png"/>
    <script type="application/javascript" src="../../content/fsdocs-theme-set-dark.js"></script>
    <link href="../../content/fsdocs-default.css" rel="stylesheet" type="text/css"/>
    <link href="../../content/fsdocs-theme.css" rel="stylesheet" type="text/css"/>

dotnet/docs dont wrong build .html book #960

Description

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions