Comments (2)
It seems _site/**/*.png
resource files are recursively included as docfx build
input.
It can be resolved by adding exclude
section to docfx.json
.
https://github.com/dotnet/docfx/blob/main/docs/docfx.json#L17-L29
from docfx.
@filzrev oh my gosh it feels so obvious now that you point it out, but I would have never guessed! I had assumed the destination folder was implicitly ignored by docfx during build. Excluding the _site folder as you suggested completely solves the problem!
For posterity, here's what my final docfx.json looks like. It's probably not necessary to add the exclusion to the content, but just added it for completeness.
{
"build": {
"content": [
{
"files": [ "**/*.yml", "**/*.md", "**/*.ipynb" ],
"exclude": [ "_site/**/*.*" ]
}
],
"resource": [
{
"files": [ "**/*.png", "**/*.jpg", "**/*.jpeg", "**/*.gif", "**/*.svg", "**/*.pdf", "**/*.pptx", "**/*.json" ],
"exclude": [ "_site/**/*.*" ]
}
],
"dest": "_site",
"globalMetadata": {
"_appTitle": "My App",
"_enableSearch": "true",
"_enableNewTab": "true"
},
"fileMetadataFiles": [],
"template": [
"default",
"modern"
],
"postProcessors": [],
"noLangKeyword": false,
"keepFileLink": false,
"cleanupCacheHistory": false,
"disableGitFeatures": false
}
}
from docfx.
Related Issues (20)
- [Feature Request] Consolidate overloads HOT 1
- How to get Extension Methods to display when using assembly references HOT 4
- [Bug] 'ApiPageDocumentProcessor': Input string was not in a correct format. HOT 1
- [Bug] Broken hrefs with `SeparatePages` when member names collide
- Enable rendering PDF-s with screen media type
- [Feature Request] Support for negative lookahead in regex / Use a more updated version of ECMAScript HOT 1
- [Call to action] Better support for partials (methods,types etc) in C# XML Doc
- Support multiple versions build
- docfx metadata hangs at: Determining projects to restore... Nothing to do. None of the projects specified contain packages to restore. HOT 13
- [Bug] IndexOutOfRangeException with FSharp assembly active pattern
- [Bug] DocFx generates incorrect links in "View Source" when building from a tag in Azure DevOps git repo HOT 3
- [Bug] Anchor links do not respect casing HOT 1
- Only some attributes are pulled into the auto-generated api .yaml files
- [Feature Request] Add support for `AllowUnsafeBlocks` in `properties`
- [Bug] StaticTOC search function does not work on Edge or Firefox HOT 2
- [Feature Request] Generated HTML should be valid XML (XHTML) HOT 1
- [Bug] Metadata extraction fails when C# projects pull in a newer compiler than DocFX ships with
- [Bug] PDF Header/Footer template path parsing HOT 1
- custom css is not applied for downloaded pdf
- [Bug] Generate documentation from dlls HOT 2
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from docfx.