Support "from" prop in pages' items

Author: roll

pages/getting-started/contributing.md CONTRIBUTING.mdpages/getting-started/contributing.md renamed to CONTRIBUTING.md

@@ -24,8 +24,8 @@ links:
       path: https://discord.com/channels/695635777199145130/695635777199145133
 pages:
   items:
-    - name: Introduction
-      path: index
+    - path: index
+      name: Introduction
     - name: Getting Started
       items:
         - path: pages/getting-started/installation
@@ -35,6 +35,7 @@ pages:
         - path: pages/getting-started/building-website
         - path: pages/getting-started/troubleshooting
         - path: pages/getting-started/contributing
+          from: CONTRIBUTING.md
     - name: Guides and Tutorials
       items:
         - path: pages/guides-and-tutorials/data-journalism

livemark.yaml

@@ -20,7 +20,7 @@ class Document:
 
     """
 
-    def __init__(self, source, *, target=None, format=None, project=None):
+    def __init__(self, source, *, target=None, format=None, project=None, path=None):
 
         # Infer target
         if not target:
@@ -41,6 +41,7 @@ def __init__(self, source, *, target=None, format=None, project=None):
         self.__target = target
         self.__format = format
         self.__project = project
+        self.__path = path
         self.__plugins = None
         self.__config = None
         self.__preface = None
@@ -162,7 +163,7 @@ def path(self):
         Returns:
             str: path
         """
-        return helpers.with_format(self.source, "")
+        return self.__path or helpers.with_format(self.source, "")
 
     @property
     def title(self):

livemark/document.py

@@ -69,9 +69,9 @@ def flatten_items(self):
     def process_project(project):
         items = project.config.get("pages", {}).get("items", [])
         for item in helpers.flatten_items(items, "items"):
-            source = helpers.with_format(item["path"], "md")
+            source = item.get("from", helpers.with_format(item["path"], "md"))
             target = helpers.with_format(item["path"], project.format)
-            document = Document(source, target=target, project=project)
+            document = Document(source, target=target, project=project, path=item["path"])
             project.documents.append(document)
 
     def process_markup(self, markup):