copy page_header.html for documentation

Author: russcam

src/CodeGeneration/DocGenerator/Documentation/Files/RawDocumentationFile.cs renamed to src/CodeGeneration/DocGenerator/Documentation/Files/AsciiDocDocumentationFile.cs

@@ -6,9 +6,9 @@
 
 namespace DocGenerator.Documentation.Files
 {
-	public class RawDocumentationFile : DocumentationFile
+	public class AsciiDocDocumentationFile : DocumentationFile
 	{
-		public RawDocumentationFile(FileInfo fileLocation) : base(fileLocation) { }
+		public AsciiDocDocumentationFile(FileInfo fileLocation) : base(fileLocation) { }
 
 		public override Task SaveToDocumentationFolderAsync()
 		{

src/CodeGeneration/DocGenerator/Documentation/Files/DocumentationFile.cs

@@ -27,7 +27,9 @@ public static DocumentationFile Load(FileInfo fileLocation)
 				case ".png":
 					return new ImageDocumentationFile(fileLocation);
 				case ".asciidoc":
-					return new RawDocumentationFile(fileLocation);
+					return new AsciiDocDocumentationFile(fileLocation);
+				case ".html":
+					return new HtmlDocumentationFile(fileLocation);
 				default:
 					throw new ArgumentOutOfRangeException(nameof(fileLocation),
 						$"The extension you specified is currently not supported: {extension}");

src/CodeGeneration/DocGenerator/Documentation/Files/HtmlDocumentationFile.cs

@@ -0,0 +1,34 @@
+using System.IO;
+using System.Text.RegularExpressions;
+using System.Threading.Tasks;
+
+namespace DocGenerator.Documentation.Files {
+	public class HtmlDocumentationFile : DocumentationFile
+	{
+		public HtmlDocumentationFile(FileInfo fileLocation) : base(fileLocation) { }
+
+		public override async Task SaveToDocumentationFolderAsync()
+		{
+			var docFileName = CreateDocumentationLocation();
+			
+			var copyRelativeTask = CopyFileAsync(FileLocation.FullName, docFileName.FullName);
+			await copyRelativeTask;
+		}
+
+		protected override FileInfo CreateDocumentationLocation()
+		{
+			var testFullPath = FileLocation.FullName;
+
+			var p = "\\" + Path.DirectorySeparatorChar.ToString();
+			var testInDocumenationFolder = Regex.Replace(testFullPath, $@"(^.+{p}Tests{p}|\" + Extension + "$)", "")
+				.PascalToHyphen() + Extension;
+
+			var documentationTargetPath = Path.GetFullPath(Path.Combine(Program.OutputDirPath, testInDocumenationFolder));
+
+			var fileInfo = new FileInfo(documentationTargetPath);
+			if (fileInfo.Directory != null)
+				Directory.CreateDirectory(fileInfo.Directory.FullName);
+			return fileInfo;
+		}
+	}
+}

src/CodeGeneration/DocGenerator/LitUp.cs

@@ -44,6 +44,9 @@ public static IEnumerable<IEnumerable<DocumentationFile>> GetDocumentFiles(Dicti
 			// process asciidocs last as they may have generated
 			// includes to other output asciidocs
 			yield return InputFiles("*.asciidoc");
+
+			// deprecation notice for old version
+			yield return InputFiles("page_header.html");
 		}
 
 		public static async Task GoAsync(string[] args)

src/Tests/Tests/page_header.html

@@ -0,0 +1,5 @@
+<p>
+  <strong>NOTE</strong>: You are looking at documentation for an older release. 
+  For the latest information, see the 
+  <a href="../current/index.html">current release documentation</a>. 
+</p>