Comments (2)
without any styles/template.
When template
is not specified. default
template is used as fallback value.
It seems same problems that are reported at (#9653)
I can also reproduce problem on my environment (Windows 11)
with following steps.
- Edit docfx official docs
docfx.json
to usedefault
template only - Run
docfx build
command - Run
docfx pdf
command - Following warnings displayed. and PDF content is corrupted.
warning: Timeout waiting for page to load, generated PDF page may be incomplete: http://127.0.0.1:59028/docfx-cli-reference/docfx.html
warning: Timeout waiting for page to load, generated PDF page may be incomplete: http://127.0.0.1:59028/docfx-cli-reference/docfx.html
And it can't be resolved with DOCFX_PDF_TIMEOUT
settings.
It seems there is problem in docfx-cli-reference/docfx.md
content.
And it can also reproduce problems with following minimum markdown/yml file.
sample.md
# docfx
toc.yml
- name: Sample
href: sample.md
from docfx.
For docfx
heading element problems.
It seems be occurred by following logics.
https://github.com/dotnet/docfx/blob/b7285fcdfb04e6f4132d702217588de6236bfa4c/src/Docfx.App/PdfBuilder.cs#L161C1-L161C92
It's not completed if docfx
ID element exists (and docfx.ready
variable is not set when using default
template)
For wrong PDF content generated problem.
It seems currently not supported usage. (As discussed at #9393)
And Create PDF Files document have following note exists.
This article applies to docfx 2.73.0 or greater and the modern site template.
from docfx.
Related Issues (20)
- [Bug] Shorthand Links are not checked for broken links HOT 1
- [Feature Request] Support fenced code block styles that compatible to `learn.microsoft.com`
- [Bug] PDF generation fails when TOC has many bookmarks HOT 1
- Search doesn't work HOT 3
- [Bug] Unable to find package docs.validation, Microsoft.Docs.MetadataService.Models, docs.validation.analyzer HOT 1
- [Feature Request] Create Class, Interface and Enums as expanders in the TOC for .NET Documentation HOT 4
- [Bug] .NET API bug - Nullable project throws error telling I should enable nullable HOT 3
- [Bug] Build-time TOC customization with `toc.extension.js` is not works when using `modern` template HOT 1
- [Bug] DocfxException: Cannot find .NET Core SDK to compile the project (but .net core 8.0.300 sdk is installed) HOT 1
- [Feature Request] Include Markdown Files by UID
- [Bug] Opening angle bracket not escaped in Markdown output HOT 1
- [Bug] Navigation area left-margin is changed when navigating between pages
- [Feature Request] Supports MPA View Transition
- [Feature Request] Unable to customize the "Inherited members" section using class.header.tmpl.partial when using apiPage outputFormat.
- [Feature Request] Add MarkdownContext to BuildOptions.ConfigureMarkdig
- [Feature Request] Support faster deserialization of `OneOf` based types
- [Bug] Ignoring global namespace prevents metadata to generate api folder HOT 5
- [Feature Request] Generate docs ONLY for stuff with the /// comment. HOT 2
- [Feature Request] Additional Schemas HOT 1
- [Feature Request] Support `Overwrite Files` feature for `"outputFormat": "apiPage"`
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.