SEO-optimization for new theme about fsharp.formatting HOT 4 CLOSED

If i understand the current system correctly, there is no default _template.html file provided by the tool, and users are expected to create their own.

That is incorrect if you don't create a _template.html file, https://github.com/fsprojects/FSharp.Formatting/blob/main/docs/_template.html will be used by the tool.

We could incorporate these SEO tags in the default template and add some more substitution parameters if necessary.

As for fsdocs init I do like that idea. It could scaffold the right files if you have absolutely nothing in your repository.

from fsharp.formatting.

Available in https://www.nuget.org/packages/fsdocs-tool/20.0.0-alpha-015

from fsharp.formatting.

If i understand the current system correctly, there is no default _template.html file provided by the tool, and users are expected to create their own. I think a fsdocs init command that provides a html template that contains the seo tags would be nice, but to make this automated, a lot of parameters have to be supplied by the user.

Example:

This is how i try to do automatic seo tags for each documentation page on plotly.net:

    <meta charset="utf-8">
    <title>{{fsdocs-page-title}}</title>
    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
    <meta name="author" content="{{fsdocs-authors}}">
    <meta name="description" content="Plotly.NET is an Interactive charting library for .NET programming languages. This page contains the documentation for: {{fsdocs-page-title}}">

    <!-- Opengraph properties (https://ogp.me/) -->
    <meta property="og:title" content="Plotly.NET documentation for: {{fsdocs-page-title}}" />
    <meta property="og:url" content="{{root}}{{fsdocs-source-basename}}.html">
    <meta property="og:type" content="website" />
    <meta property="og:site_name" content="Plotly.NET" />
    <meta property="og:description" content="Plotly.NET is an Interactive charting library for .NET programming languages. This page contains the documentation for: {{fsdocs-page-title}}">
    <meta property="og:image" content="{{root}}img/logo_meta_tags.png">

    <!-- Twitter cards -->
    <meta name="twitter:card" content="summary_large_image">
    <meta property="twitter:domain" content="{{root}}{{fsdocs-source-basename}}.html">
    <meta property="twitter:url" content="https://plotly.net">
    <meta name="twitter:title" content="Plotly.NET documentation for: {{fsdocs-page-title}}">
    <meta name="twitter:description" content="Plotly.NET is an Interactive charting library for .NET programming languages. This page contains the documentation for: {{fsdocs-page-title}}">
    <meta name="twitter:image" content="{{root}}img/logo_meta_tags.png">

As you see, this is done via the substitution parameters, but if the user does not supply these, the meta tags are rubbish.

from fsharp.formatting.

That is incorrect if you don't create a _template.html file

I see, sorry has been a long time since i did set up from scratch

We could incorporate these SEO tags in the default template and add some more substitution parameters if necessary.

These are always known to the tool right?

• {{root}}
• {{fsdocs-source-basename}}
• {{fsdocs-page-title}}

If that is the case, most of the tags can be reliably created, while i think {{fsdocs-authors}} must be provided by the user, and therefore could just be left out of the template, preventing people from ending up with '{{fsdocs-authors}}' as their author tag.

from fsharp.formatting.