WIP: override support

toolsrc/Chloroplast.Core/Content/ContentArea.cs

@@ -49,7 +49,8 @@ public static IEnumerable<ContentArea> LoadContentAreas (IConfigurationRoot conf
                     TargetPath = outDirectory.CombinePath (areaConfig["output_folder"].NormalizePath(toLower: normalizePaths)),
                     RootRelativePath = areaConfig["output_folder"].Replace ("index.html", "").NormalizePath (toLower: normalizePaths),
                     NormalizePaths = normalizePaths,
-                    AreaType = areaConfig["type"]
+                    AreaType = areaConfig["type"],
+                    OverridePath = rootDirectory.CombinePath (areaConfig["override_folder"])
                 };
 
                 // TODO: validate values
@@ -93,7 +94,8 @@ public string AreaType
                 if (!string.IsNullOrWhiteSpace (value))
                     areaType = value;
             }
-        } 
+        }
+        public string OverridePath { get; set; }
 
         public GroupContentArea ()
         {

toolsrc/Chloroplast.Core/Extensions/PathExtensions.cs

@@ -1,5 +1,6 @@
 using System;
 using System.IO;
+using System.Linq;
 
 namespace Chloroplast.Core.Extensions
 {
@@ -36,7 +37,9 @@ public static string GetPathFileName(this string value)
 
         public static string CombinePath(this string value, params string[] paths)
         {
-            string combinedPaths = Path.Combine (paths).NormalizePath ();
+            if (value == null) value = string.Empty;
+
+            string combinedPaths = Path.Combine (paths.Where(p => !string.IsNullOrWhiteSpace(p)).ToArray()).NormalizePath ();
             if (combinedPaths.StartsWith (Path.DirectorySeparatorChar))
                 combinedPaths = combinedPaths.Substring (1);
 

toolsrc/Chloroplast.Core/Loaders/EcmaXmlExtensions.cs

@@ -106,6 +106,13 @@ public class XType
         [XmlAttribute]
         public string FullName { get; set; }
 
+        public string Namespace {
+            get
+            {
+                return FullName.Replace ("." + Name, string.Empty);
+            }
+        }
+
         [XmlElement ("TypeSignature")]
         public List<XSignature> Signatures { get; set; } = new List<XSignature> ();
 

toolsrc/Chloroplast.Core/Rendering/EcmaXmlRenderer.cs

@@ -1,5 +1,7 @@
 using System;
+using System.IO;
 using System.Threading.Tasks;
+using Chloroplast.Core.Content;
 using Chloroplast.Core.Loaders;
 using Microsoft.Extensions.Configuration;
 using EcmaXml = Chloroplast.Core.Loaders.EcmaXml;
@@ -19,7 +21,32 @@ public static async Task<RenderedContent> Render (ContentNode item, string body,
 
             if (body.StartsWith ("<Type "))
             {
+                GroupContentArea groupArea = item.Area as GroupContentArea;
+
                 var t = EcmaXmlLoader.LoadXType (body);
+
+                // TODO: use groupArea.OverridePath to look for the type's override files if any
+                // and also all members
+                // for uid, use t.FullName
+                if (groupArea != null && Directory.Exists(groupArea.OverridePath))
+                {
+                    var overrideFile = Path.Combine (groupArea.OverridePath,t.Namespace, t.FullName + ".md");
+                    if (File.Exists(overrideFile))
+                    {
+                        t.Docs.Remarks = File.ReadAllText (overrideFile);
+                    }
+
+                    foreach(var m in t.Members)
+                    {
+                        // TODO: look for override file for this member
+                        overrideFile = Path.Combine (groupArea.OverridePath, t.Namespace, t.FullName + "." + m.Name + ".md");
+                        if (File.Exists (overrideFile))
+                        {
+                            m.Docs.Remarks = File.ReadAllText (overrideFile);
+                        }
+                    }
+                }
+
                 var nscontent = ToEcmaContent (item, config, t);
 
                 var result = await ContentRenderer.ToRazorAsync (nscontent);