dotnet / dotnet/docfx

How to configure customized logo

Open
#10,948 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
C#
Stars
4.4k
Forks
890
Avg merge
2h 9m
Merged PRs (30d)
11

Description

When I tried to use a customized app logo, the svg displayed abnormal, how could I adjust the style or adjust the image aspectio?

Image

docfx config:

```json
{
"build": {
"globalMetadata": {
"_appName": "dotnet-talks",
"_appTitle": ".NET Talks",
"_appLogoPath": "images/dotnet-logo.svg",
"_appFaviconPath": "images/favicon.ico",
"_enableSearch": true,
"pdf": false
}
}
}
```

The dotnet-logo.svg is as follow:

```xml

```

Contributor guide

Open the contributing guide

Research direction

Start with the shown docfx config and dotnet-logo.svg, then trace how _appLogoPath is consumed in the generated site. Reproduce the abnormal rendering and compare the logo's displayed aspect and styling with the SVG dimensions. Done means a customized SVG logo renders normally in the generated documentation.

Written by the indexing model from the issue text.

Assessment

Tech stack
json, xml
Domain
documentation, frontend
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.