如何降低docfx冗長度？

Question

我們使用docfx，它作為一個nuget包含在我們的一個csproj文件中。 我沒有親自設置這個東西，我沒有關於它如何工作的更多信息，但它看起來像一個簡單的nuget添加到C＃項目，然后在Visual Studio中的項目編譯期間生成文檔。

我們的問題是構建日志的詳細程度總是設置為詳細（或詳細或他們如何調用它），即我在解決方案中有20個c＃項目，因為我沒有警告或錯誤，“輸出”窗口中的構建輸出是整個解決方案非常短，每個項目只需幾行。 但是這個帶有d​​ocfx的項目在編譯期間總是產生很多輸出，因為它將所有詳細消息寫入Output窗口（以及放置在項目目錄中的log.txt文件）。

問題是如何從“輸出”窗口中刪除它。 我試着谷歌它，我發現命令行上的--logLevel警告參數可以降低詳細程度。 但是我們不使用任何命令行，我們在項目中有nuget。 而且我看不到可以指定這個--logLevel警告的地方。

（使用最新的nuget“docfx.console”版本2.40.4，C＃項目屬於類庫。我在任何地方都看不到任何特殊設置。對於輸出窗口和日志文件，msbuild verbosity的Visual Studio設置都設置為最小。 ）

Answer 1

編輯：自從我第一次回復以來，我發現了一個更好的方法在項目層面上做到這一點。

如果編輯DocFx項目的.csproj文件以包含以下屬性組，則可以在項目上設置日志級別。

<PropertyGroup>
  <LogLevel>Warning</LogLevel>
</PropertyGroup>

我從這個git問題的評論中得到了這個想法： https ： //github.com/dotnet/docfx/issues/2595#issuecomment-379947069

---

原始回應：

我只找到了一種方法，但它將在全球范圍內，如果你升級到新版本，你可能不得不重新設置它。

您可以修改docfx.console.targets文件以更改日志級別。 在我的電腦上找到它

C:\Users\<username>\.nuget\packages\docfx.console\<version number>\build\docfx.console.targets

這是一個XML文件，您可以在其中設置要使用的日志級別。

<Project ...>
  <PropertyGroup>
    ...
    <LogLevel Condition=" '$(LogLevel)' == '' ">Verbose</LogLevel>
    ...
  </PropertyGroup>

我將“詳細”更改為“警告”，它顯着減少了生成的日志消息。

希望這也可以幫到你！