Giters

docascode / docfx-seed

A sample documentation project, containing .NET source code and markdown files, can generate a static website after running docfx

Home Page:http://docascode.github.io/docfx-seed/index.html

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Fails to build on linux

clayrisser opened this issue · comments

commented

I get the following error when building on linux.

docfx build
Loading docsets...
Loading config...
Restoring dependencies...
Building...
schema-not-found ./restapi/petstore.swagger.json(1,1): Unknown schema ''.
schema-not-found ./restapi/contacts_swagger2.json(1,1): Unknown schema ''.
schema-not-found ./toc.yml(1,1): Unknown schema ''.
liquid-not-found ./README.md(1,1): Liquid template is not found for mime type 'Conceptual', the output HTML will not be generated.
liquid-not-found ./articles/docfx_getting_started.md(1,1): Liquid template is not found for mime type 'Conceptual', the output HTML will not be generated.
liquid-not-found ./articles/engineering_guidelines.md(1,1): Liquid template is not found for mime type 'Conceptual', the output HTML will not be generated.
liquid-not-found ./restapi/toc.md(1,1): Liquid template is not found for mime type 'Conceptual', the output HTML will not be generated.
liquid-not-found ./index.md(1,1): Liquid template is not found for mime type 'Conceptual', the output HTML will not be generated.
liquid-not-found ./articles/toc.md(1,1): Liquid template is not found for mime type 'Conceptual', the output HTML will not be generated.
liquid-not-found ./articles/csharp_coding_standards.md(1,1): Liquid template is not found for mime type 'Conceptual', the output HTML will not be generated.
build done in 626.92ms

  3 Error(s), 7 Warning(s), 0 Suggestion(s)
commented

experiencing the same issue

commented

disclaimer: I'm not by any means not even remotely an expert on docfx, I just had to use it and came across the same problem. Here's how I made it work:

  • create a new project
  • take this "seed" site and replace everything in the newly created project,
  • build
  • serve

I tried this on Windows, something similar should works on linux

>mkdir my-site
>cd my-site
>docfx new conceptual

At this point grab the content of the seed repo and "dump" it into `my-site' then:

>docfx build
>docfx serve

It'd be great If the Repo Owners could shed some light on this