How to collect all xml-documentation from projects in solution with docfx?

Question

I have structure of solution like this:

Solution
--Project.DAL
------bin
------obj
------Project.DAL.csproj
--Project.BLL
------bin
------obj
------Project.BLL.csproj
--Project.View
------bin
------obj
------Project.View.csproj
--Project.Documentaion
------_site
------another-files-of-docfx

I tryed change props and values of docfx.json

    {
      "src": [
        {
          "files": [
            "Project.DAL.csproj",
            "Project.BLL.csproj",
            "Project.View.csproj"
          ],
          "src": "Project"
        }
      ],
      "dest": "api",
      "disableGitFeatures": false,
      "disableDefaultFilter": false
    }

Every project has nugetpackage docfx.console. I have documentation in every project after building solution. I want to collect all xml-documentation of projects in solution to folder Project.Documentation. Please tell me, its possible or not? If yes, can you help me and tell me what i did wrong and where, please?

score 0 · Answer 1 · answered Mar 01 '20 at 12:46

See if following works. I could use xml linq instead of using regex. :

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.IO;
using System.Text.RegularExpressions;

namespace ConsoleApplication1
{
    class Program
    {
        static void Main(string[] args)
        {
            string mainProject = @"c:\temp\myProject.csproj";
            string projectName = mainProject.Substring(mainProject.LastIndexOf("\\") + 1);
            string folder = mainProject.Substring(0, mainProject.LastIndexOf("\\") + 1);
            GetProjectsRecursive(folder, projectName, 0);
            Console.ReadLine();
        }
        static void GetProjectsRecursive(string folder, string project, int level)
        {
            string pattern = "<ProjectReference Include=\"(?'project'[^\"]+)";

            if (File.Exists(folder + project))
            {
                string contents = File.ReadAllText(folder + project);
                MatchCollection matches = Regex.Matches(contents, pattern, RegexOptions.Multiline);
                if (matches.Count > 0)
                {
                    foreach (Match match in matches)
                    {
                        string projectName = match.Groups["project"].Value;
                        string childProjectName = projectName.Substring(projectName.LastIndexOf("\\") + 1);
                        string childFolder = projectName.Substring(0, projectName.LastIndexOf("\\") + 1);
                        Console.WriteLine("{0}Project : '{1}', Refeference Project : '{2}'", new string(' ', level), project, projectName);

                        if (childFolder.StartsWith("..\\"))
                        {
                            childFolder = folder + childFolder;
                        }
                        GetProjectsRecursive(childFolder, childProjectName, level + 1);
                    }
                }
            }
            else
            {
                Console.WriteLine("Project Does Not Exist : '{0}'", folder + project);
            }
        }
    }
}

How to collect all xml-documentation from projects in solution with docfx?

1 Answers1