Merge pull request #3 from yamatora/develop

Develop

.gitignore

@@ -0,0 +1 @@
+/doc

src/doc/.gitignore

@@ -0,0 +1,9 @@
+###############
+#    folder   #
+###############
+/**/DROP/
+/**/TEMP/
+/**/packages/
+/**/bin/
+/**/obj/
+_site

src/doc/api/.gitignore

@@ -0,0 +1,5 @@
+###############
+#  temp file  #
+###############
+*.yml
+.manifest

src/doc/api/index.md

@@ -0,0 +1,2 @@
+# PLACEHOLDER
+TODO: Add .NET projects to the *src* folder and run `docfx` to generate **REAL** *API Documentation*!

src/doc/articles/intro.md

@@ -0,0 +1 @@
+# Add your introductions here!

src/doc/articles/toc.yml

@@ -0,0 +1,2 @@
+- name: Introduction
+  href: intro.md

src/doc/doc.csproj

@@ -0,0 +1,24 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net6.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="docfx.console" Version="2.59.3">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\libymtr\libymtr.csproj" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <Folder Include="src\" />
+  </ItemGroup>
+
+</Project>

src/doc/docfx.json

@@ -0,0 +1,65 @@
+{
+  "metadata": [
+    {
+      "src": [
+        {
+          "files": [
+            "libymtr.dll"
+          ],
+          "src": "../libymtr/bin/Release/net6.0",
+        }
+      ],
+      "dest": "api",
+      "disableGitFeatures": false,
+      "disableDefaultFilter": false
+    }
+  ],
+  "build": {
+    "content": [
+      {
+        "files": [
+          "api/**.yml",
+          "api/index.md"
+        ]
+      },
+      {
+        "files": [
+          "articles/**.md",
+          "articles/**/toc.yml",
+          "toc.yml",
+          "*.md"
+        ]
+      }
+    ],
+    "resource": [
+      {
+        "files": [
+          "images/**"
+        ]
+      }
+    ],
+    "overwrite": [
+      {
+        "files": [
+          "apidoc/**.md"
+        ],
+        "exclude": [
+          "obj/**",
+          "_site/**"
+        ]
+      }
+    ],
+    "dest": "_site",
+    "globalMetadataFiles": [],
+    "fileMetadataFiles": [],
+    "template": [
+      "default"
+    ],
+    "postProcessors": [],
+    "markdownEngineName": "markdig",
+    "noLangKeyword": false,
+    "keepFileLink": false,
+    "cleanupCacheHistory": false,
+    "disableGitFeatures": false
+  }
+}

src/doc/index.md

@@ -0,0 +1,4 @@
+# This is the **HOMEPAGE**.
+Refer to [Markdown](http://daringfireball.net/projects/markdown/) for how to write markdown files.
+## Quick Start Notes:
+1. Add images to the *images* folder if the file is referencing an image.

src/doc/log.txt

@@ -0,0 +1,31 @@
+{"message":"Workspace failed with: [Failure] Msbuild failed when processing the file 'C:\\Users\\yamatora\\Desktop\\dev\\PROJECT\\libymtr\\src\\doc\\doc.csproj' with message: メソッドが見つかりません: 'System.ReadOnlySpan`1<Char> Microsoft.IO.Path.GetFileName(System.ReadOnlySpan`1<Char>)'","source":"MetadataCommand.ExtractMetadata","file":"C:/Users/yamatora/Desktop/dev/PROJECT/libymtr/src/doc/doc.csproj","date_time":"2022-08-28T16:30:21.8775366Z","message_severity":"warning","correlation_id":"BF52A8D0-2A5D-49CF-BB90-E47493C46AD3.1.1.5"}
+{"message":"Project 'C:\\Users\\yamatora\\Desktop\\dev\\PROJECT\\libymtr\\src\\doc\\doc.csproj' does not contain any documents.","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:30:22.2661227Z","message_severity":"warning","correlation_id":"BF52A8D0-2A5D-49CF-BB90-E47493C46AD3.1.1.8"}
+{"message":"No metadata is generated for doc.","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:30:22.7120796Z","message_severity":"warning","correlation_id":"BF52A8D0-2A5D-49CF-BB90-E47493C46AD3.1.1.13"}
+{"message":"Workspace failed with: [Failure] Msbuild failed when processing the file 'C:\\Users\\yamatora\\Desktop\\dev\\PROJECT\\libymtr\\src\\libymtr\\libymtr.csproj' with message: メソッドが見つかりません: 'System.ReadOnlySpan`1<Char> Microsoft.IO.Path.GetFileName(System.ReadOnlySpan`1<Char>)'","source":"MetadataCommand.ExtractMetadata","file":"C:/Users/yamatora/Desktop/dev/PROJECT/libymtr/src/libymtr/libymtr.csproj","date_time":"2022-08-28T16:31:44.4862864Z","message_severity":"warning","correlation_id":"B807FD46-7C5C-4D40-8984-C32852D40772.1.1.5"}
+{"message":"Project 'C:\\Users\\yamatora\\Desktop\\dev\\PROJECT\\libymtr\\src\\libymtr\\libymtr.csproj' does not contain any documents.","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:31:44.8772441Z","message_severity":"warning","correlation_id":"B807FD46-7C5C-4D40-8984-C32852D40772.1.1.8"}
+{"message":"No metadata is generated for libymtr.","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:31:45.2253003Z","message_severity":"warning","correlation_id":"B807FD46-7C5C-4D40-8984-C32852D40772.1.1.13"}
+{"message":"Workspace failed with: [Failure] Msbuild failed when processing the file 'C:\\Users\\yamatora\\Desktop\\dev\\PROJECT\\libymtr\\src\\libymtr\\libymtr.csproj' with message: メソッドが見つかりません: 'System.ReadOnlySpan`1<Char> Microsoft.IO.Path.GetFileName(System.ReadOnlySpan`1<Char>)'","source":"MetadataCommand.ExtractMetadata","file":"C:/Users/yamatora/Desktop/dev/PROJECT/libymtr/src/libymtr/libymtr.csproj","date_time":"2022-08-28T16:34:32.6073979Z","message_severity":"warning","correlation_id":"A5F2BBC1-182A-4623-ABDA-05DEC535353C.1.1.5"}
+{"message":"Project 'C:\\Users\\yamatora\\Desktop\\dev\\PROJECT\\libymtr\\src\\libymtr\\libymtr.csproj' does not contain any documents.","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:34:33.0695765Z","message_severity":"warning","correlation_id":"A5F2BBC1-182A-4623-ABDA-05DEC535353C.1.1.8"}
+{"message":"No metadata is generated for libymtr.","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:34:33.3886524Z","message_severity":"warning","correlation_id":"A5F2BBC1-182A-4623-ABDA-05DEC535353C.1.1.15"}
+{"message":"Workspace failed with: [Failure] Msbuild failed when processing the file 'C:\\Users\\yamatora\\Desktop\\dev\\PROJECT\\libymtr\\src\\libymtr\\libymtr.csproj' with message: メソッドが見つかりません: 'System.ReadOnlySpan`1<Char> Microsoft.IO.Path.GetFileName(System.ReadOnlySpan`1<Char>)'","source":"MetadataCommand.ExtractMetadata","file":"C:/Users/yamatora/Desktop/dev/PROJECT/libymtr/src/libymtr/libymtr.csproj","date_time":"2022-08-28T16:35:09.7247328Z","message_severity":"warning","correlation_id":"E38CA49B-F4B8-4EC0-8D20-1BDB1DCB1D1F.1.1.5"}
+{"message":"Project 'C:\\Users\\yamatora\\Desktop\\dev\\PROJECT\\libymtr\\src\\libymtr\\libymtr.csproj' does not contain any documents.","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:35:10.1567594Z","message_severity":"warning","correlation_id":"E38CA49B-F4B8-4EC0-8D20-1BDB1DCB1D1F.1.1.8"}
+{"message":"No metadata is generated for libymtr.","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:35:10.5155631Z","message_severity":"warning","correlation_id":"E38CA49B-F4B8-4EC0-8D20-1BDB1DCB1D1F.1.1.13"}
+{"message":"Workspace failed with: [Failure] Msbuild failed when processing the file 'C:\\Users\\yamatora\\Desktop\\dev\\PROJECT\\libymtr\\src\\libymtr\\libymtr.csproj' with message: メソッドが見つかりません: 'System.ReadOnlySpan`1<Char> Microsoft.IO.Path.GetFileName(System.ReadOnlySpan`1<Char>)'","source":"MetadataCommand.ExtractMetadata","file":"C:/Users/yamatora/Desktop/dev/PROJECT/libymtr/src/libymtr/libymtr.csproj","date_time":"2022-08-28T16:39:10.8086104Z","message_severity":"warning","correlation_id":"2B8CB1DA-D674-46A7-87F7-0162B018CD89.1.1.5"}
+{"message":"Project 'C:\\Users\\yamatora\\Desktop\\dev\\PROJECT\\libymtr\\src\\libymtr\\libymtr.csproj' does not contain any documents.","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:39:11.220538Z","message_severity":"warning","correlation_id":"2B8CB1DA-D674-46A7-87F7-0162B018CD89.1.1.8"}
+{"message":"No metadata is generated for libymtr.","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:39:11.616439Z","message_severity":"warning","correlation_id":"2B8CB1DA-D674-46A7-87F7-0162B018CD89.1.1.13"}
+{"message":"Workspace failed with: [Failure] Msbuild failed when processing the file 'C:\\Users\\yamatora\\Desktop\\dev\\PROJECT\\libymtr\\src\\libymtr\\libymtr.csproj' with message: メソッドが見つかりません: 'System.ReadOnlySpan`1<Char> Microsoft.IO.Path.GetFileName(System.ReadOnlySpan`1<Char>)'","source":"MetadataCommand.ExtractMetadata","file":"C:/Users/yamatora/Desktop/dev/PROJECT/libymtr/src/libymtr/libymtr.csproj","date_time":"2022-08-28T16:40:43.1757249Z","message_severity":"warning","correlation_id":"01063A85-F2FC-4759-9FE2-8F872E8F0697.1.1.5"}
+{"message":"Project 'C:\\Users\\yamatora\\Desktop\\dev\\PROJECT\\libymtr\\src\\libymtr\\libymtr.csproj' does not contain any documents.","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:40:43.5636224Z","message_severity":"warning","correlation_id":"01063A85-F2FC-4759-9FE2-8F872E8F0697.1.1.8"}
+{"message":"No metadata is generated for libymtr.","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:40:43.9871764Z","message_severity":"warning","correlation_id":"01063A85-F2FC-4759-9FE2-8F872E8F0697.1.1.13"}
+{"message":"Workspace failed with: [Failure] Msbuild failed when processing the file 'C:\\Users\\yamatora\\Desktop\\dev\\PROJECT\\libymtr\\src\\libymtr\\libymtr.csproj' with message: メソッドが見つかりません: 'System.ReadOnlySpan`1<Char> Microsoft.IO.Path.GetFileName(System.ReadOnlySpan`1<Char>)'","source":"MetadataCommand.ExtractMetadata","file":"C:/Users/yamatora/Desktop/dev/PROJECT/libymtr/src/libymtr/libymtr.csproj","date_time":"2022-08-28T16:44:25.1623775Z","message_severity":"warning","correlation_id":"A0964750-83CE-4623-A259-B293A53EBB71.1.1.5"}
+{"message":"Project 'C:\\Users\\yamatora\\Desktop\\dev\\PROJECT\\libymtr\\src\\libymtr\\libymtr.csproj' does not contain any documents.","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:44:25.5393732Z","message_severity":"warning","correlation_id":"A0964750-83CE-4623-A259-B293A53EBB71.1.1.8"}
+{"message":"No metadata is generated for libymtr.","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:44:25.8491688Z","message_severity":"warning","correlation_id":"A0964750-83CE-4623-A259-B293A53EBB71.1.1.15"}
+{"message":"Workspace failed with: [Failure] Msbuild failed when processing the file 'C:\\Users\\yamatora\\Desktop\\dev\\PROJECT\\libymtr\\src\\libymtr\\libymtr.csproj' with message: メソッドが見つかりません: 'System.ReadOnlySpan`1<Char> Microsoft.IO.Path.GetFileName(System.ReadOnlySpan`1<Char>)'","source":"MetadataCommand.ExtractMetadata","file":"C:/Users/yamatora/Desktop/dev/PROJECT/libymtr/src/libymtr/libymtr.csproj","date_time":"2022-08-28T16:56:38.3788785Z","message_severity":"warning","correlation_id":"5CB640BE-CF2D-4AD2-89E3-2C90BACB28DE.1.1.5"}
+{"message":"Project 'C:\\Users\\yamatora\\Desktop\\dev\\PROJECT\\libymtr\\src\\libymtr\\libymtr.csproj' does not contain any documents.","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:56:39.0515628Z","message_severity":"warning","correlation_id":"5CB640BE-CF2D-4AD2-89E3-2C90BACB28DE.1.1.8"}
+{"message":"No metadata is generated for libymtr.","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:56:39.5150882Z","message_severity":"warning","correlation_id":"5CB640BE-CF2D-4AD2-89E3-2C90BACB28DE.1.1.15"}
+{"message":"Unable to get symbol from C:/Users/yamatora/Desktop/dev/PROJECT/libymtr/src/libymtr/bin/Debug/net6.0/libymtr.dll, ignored...","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:59:06.5662191Z","message_severity":"warning","correlation_id":"2BDB3785-3E01-4C31-AFC5-728DDA260A00.1.1.5"}
+{"message":"Unable to get symbol from C:/Users/yamatora/Desktop/dev/PROJECT/libymtr/src/libymtr/bin/Release/net6.0/libymtr.dll, ignored...","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:59:06.5712227Z","message_severity":"warning","correlation_id":"2BDB3785-3E01-4C31-AFC5-728DDA260A00.1.1.7"}
+{"message":"Unable to get symbol from C:/Users/yamatora/Desktop/dev/PROJECT/libymtr/src/libymtr/obj/Debug/net6.0/libymtr.dll, ignored...","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:59:06.5712227Z","message_severity":"warning","correlation_id":"2BDB3785-3E01-4C31-AFC5-728DDA260A00.1.1.9"}
+{"message":"Unable to get symbol from C:/Users/yamatora/Desktop/dev/PROJECT/libymtr/src/libymtr/obj/Debug/net6.0/ref/libymtr.dll, ignored...","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:59:06.5712227Z","message_severity":"warning","correlation_id":"2BDB3785-3E01-4C31-AFC5-728DDA260A00.1.1.11"}
+{"message":"Unable to get symbol from C:/Users/yamatora/Desktop/dev/PROJECT/libymtr/src/libymtr/obj/Debug/net6.0/refint/libymtr.dll, ignored...","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:59:06.5712227Z","message_severity":"warning","correlation_id":"2BDB3785-3E01-4C31-AFC5-728DDA260A00.1.1.13"}
+{"message":"Unable to get symbol from C:/Users/yamatora/Desktop/dev/PROJECT/libymtr/src/libymtr/obj/Release/net6.0/libymtr.dll, ignored...","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:59:06.5712227Z","message_severity":"warning","correlation_id":"2BDB3785-3E01-4C31-AFC5-728DDA260A00.1.1.15"}
+{"message":"Unable to get symbol from C:/Users/yamatora/Desktop/dev/PROJECT/libymtr/src/libymtr/obj/Release/net6.0/ref/libymtr.dll, ignored...","source":"MetadataCommand.ExtractMetadata","date_time":"2022-08-28T16:59:06.5712227Z","message_severity":"warning","correlation_id":"2BDB3785-3E01-4C31-AFC5-728DDA260A00.1.1.17"}

src/doc/toc.yml

@@ -0,0 +1,5 @@
+- name: Articles
+  href: articles/
+- name: Api Documentation
+  href: api/
+  homepage: api/index.md

libymtr/libymtr.sln → src/libymtr.sln

@@ -10,6 +10,8 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution
 		.editorconfig = .editorconfig
 	EndProjectSection
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "doc", "doc\doc.csproj", "{11935008-6F1C-471B-8384-6A6B5BD94E80}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -20,6 +22,10 @@ Global
 		{092F3042-0EEE-4448-B66E-E51F7A65CF4F}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{092F3042-0EEE-4448-B66E-E51F7A65CF4F}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{092F3042-0EEE-4448-B66E-E51F7A65CF4F}.Release|Any CPU.Build.0 = Release|Any CPU
+		{11935008-6F1C-471B-8384-6A6B5BD94E80}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{11935008-6F1C-471B-8384-6A6B5BD94E80}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{11935008-6F1C-471B-8384-6A6B5BD94E80}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{11935008-6F1C-471B-8384-6A6B5BD94E80}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE

libymtr/libymtr/Generic.cs → src/libymtr/Generic.cs

@@ -8,7 +8,7 @@ namespace libymtr {
     /// <summary>
     /// Generic type function
     /// </summary>
-    internal class Generic {
+    public class Generic {
         /// <summary>
         /// Concat <T> array with splitter
         /// </summary>

libymtr/libymtr/Windows/Registry/Environment.cs → src/libymtr/Windows/Registry/Environment.cs

@@ -10,7 +10,7 @@
 using System.Reflection;
 
 namespace libymtr.Windows.Registry {
-    internal class Environment {
+    public class Environment {
         //  Variable name
         private const string NAME_PATH = "Path";
         //  Message

libymtr/libymtr/Windows/Windows.cs → src/libymtr/Windows/Windows.cs

@@ -6,7 +6,7 @@
 using System.Threading.Tasks;
 
 namespace libymtr.Windows {
-    internal class Windows {
+    public class Windows {
         private const string MSG_WINDOWS_ONLY = "Work on Windows only";
         private static Exception WindowsOnlyException {
             get {
@@ -17,7 +17,7 @@ private static Exception WindowsOnlyException {
         /// <summary>
         /// Check whether os is Windows
         /// </summary>
-        internal static void CheckOS() {
+        public static void CheckOS() {
             if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows)) {
                 return;
             }

src/libymtr/libymtr.csproj

@@ -0,0 +1,13 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net6.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <None Include="..\.editorconfig" Link=".editorconfig" />
+  </ItemGroup>
+
+</Project>