[Pipeline] Update link check error display (#343)

# Description

- Update link check error display

![image](https://github.com/microsoft/promptflow/assets/2572521/507f3af8-7883-4d97-b22f-e703eb0553b5)
- Update publish doc pipeline to include promptflow source code path

# All Promptflow Contribution checklist:
- [ ] **The pull request does not introduce [breaking changes]**
- [ ] **CHANGELOG is updated for new features, bug fixes or other
significant changes.**
- [ ] **I have read the [contribution guidelines](../CONTRIBUTING.md).**

## General Guidelines and Best Practices
- [ ] Title of the pull request is clear and informative.
- [ ] There are a small number of commits, each of which have an
informative message. This means that previously merged commits do not
appear in the history of the PR. For more information on cleaning up the
commits in your PR, [see this
page](https://github.com/Azure/azure-powershell/blob/master/documentation/development-docs/cleaning-up-commits.md).

### Testing Guidelines
- [ ] Pull request includes test coverage for the included changes.

Author: 0mza987

.github/workflows/publish_doc.yml

@@ -11,6 +11,7 @@ on:
       - 'docs/**'
       - 'scripts/docs/**'
       - '.github/workflows/publish_doc.yml'
+      - 'src/promptflow/promptflow/**'
 
 # Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
 permissions:

scripts/docs/doc_generation.ps1

@@ -21,6 +21,11 @@ param(
 [string] $TempDocPath = New-TemporaryFile | % { Remove-Item $_; New-Item -ItemType Directory -Path $_ }
 [string] $PkgSrcPath = [System.IO.Path]::Combine($RepoRootPath, "src\promptflow\promptflow")
 [string] $OutPath = [System.IO.Path]::Combine($ScriptPath, "_build")
+[string] $SphinxApiDoc = [System.IO.Path]::Combine($DocPath, "sphinx_apidoc.log")
+[string] $SphinxBuildDoc = [System.IO.Path]::Combine($DocPath, "sphinx_build.log")
+[string] $WarningErrorPattern = "WARNING:|ERROR:"
+$apidocWarningsAndErrors = $null
+$buildWarningsAndErrors = $null
 
 if (-not $SkipInstall){
     # Prepare doc generation packages
@@ -65,7 +70,8 @@ if($WithReferenceDoc){
     }
     Remove-Item $RefDocPath -Recurse -Force
     Write-Host "===============Build Promptflow Reference Doc==============="
-    sphinx-apidoc --module-first --no-headings --no-toc --implicit-namespaces "$PkgSrcPath" -o "$RefDocPath"
+    sphinx-apidoc --module-first --no-headings --no-toc --implicit-namespaces "$PkgSrcPath" -o "$RefDocPath" | Tee-Object -FilePath $SphinxApiDoc 
+    $apidocWarningsAndErrors = Select-String -Path $SphinxApiDoc -Pattern $WarningErrorPattern
 }
 
 
@@ -78,7 +84,22 @@ if($WarningAsError){
 if($BuildLinkCheck){
     $BuildParams.Add("-blinkcheck")
 }
-sphinx-build $TempDocPath $OutPath -c $ScriptPath $BuildParams
+sphinx-build $TempDocPath $OutPath -c $ScriptPath $BuildParams | Tee-Object -FilePath $SphinxBuildDoc
+$buildWarningsAndErrors = Select-String -Path $SphinxBuildDoc -Pattern $WarningErrorPattern
 
 Write-Host "Clean path: $TempDocPath"
 Remove-Item $TempDocPath -Recurse -Confirm:$False -Force
+
+if ($apidocWarningsAndErrors) {  
+    Write-Host "=============== API doc warnings and errors ==============="  
+    foreach ($line in $apidocWarningsAndErrors) {  
+        Write-Host $line -ForegroundColor Red  
+    }  
+}  
+  
+if ($buildWarningsAndErrors) {  
+    Write-Host "=============== Build warnings and errors ==============="  
+    foreach ($line in $buildWarningsAndErrors) {  
+        Write-Host $line -ForegroundColor Red  
+    }  
+}