Simple config for replacing logo

[roji]

#239 describes how to override the navbar partial in order to replace the logo (upper-left corner).

It seems like there should be a much easier config option for doing this - practically every documentation site out there will want to put their project's logo, and overriding template partials is dangerous for compatibility as the template changes. Would you consider docfx global metadata option(s) for managing this?

[superyyrrzz]

Yes, we can provide a metadata _appLogoPath to replace logo.svg here. Then by minor customizing the template to provide your own logo file, you can replace logo while keep the template compatible.

[superyyrrzz]

Now in DocFX 2.8, you can use _appLogoPath and _appFaviconPath in global metadata to customize it.

[roji]

@superyyrrzz great! Should I leave this open for tracking splitting out the logo into its own separate partial?

[superyyrrzz]

It's also implemented. See: https://github.com/dotnet/docfx/blob/dev/src/docfx.website.themes/default/partials/navbar.tmpl.partial#L12

[roji]

Oh awesome! Thanks!