{"action":"created","issue":{"url":"https://api.github.com/repos/fletcher/MultiMarkdown-4/issues/112","labels_url":"https://api.github.com/repos/fletcher/MultiMarkdown-4/issues/112/labels{/name}","comments_url":"https://api.github.com/repos/fletcher/MultiMarkdown-4/issues/112/comments","events_url":"https://api.github.com/repos/fletcher/MultiMarkdown-4/issues/112/events","html_url":"https://github.com/fletcher/MultiMarkdown-4/issues/112","id":69768382,"number":112,"title":"Request: Include Paths to CLI","user":{"login":"bdkjones","id":926566,"avatar_url":"https://avatars.githubusercontent.com/u/926566?v=3","gravatar_id":"","url":"https://api.github.com/users/bdkjones","html_url":"https://github.com/bdkjones","followers_url":"https://api.github.com/users/bdkjones/followers","following_url":"https://api.github.com/users/bdkjones/following{/other_user}","gists_url":"https://api.github.com/users/bdkjones/gists{/gist_id}","starred_url":"https://api.github.com/users/bdkjones/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bdkjones/subscriptions","organizations_url":"https://api.github.com/users/bdkjones/orgs","repos_url":"https://api.github.com/users/bdkjones/repos","events_url":"https://api.github.com/users/bdkjones/events{/privacy}","received_events_url":"https://api.github.com/users/bdkjones/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-04-21T07:33:30Z","updated_at":"2015-04-21T08:26:03Z","closed_at":null,"body":"Suppose I have a Markdown file that includes another, like this:\r\n\r\n```\r\n## This is a Header\r\n\r\nBring in some content!\r\n{{content.md}}\r\n```\r\n\r\nNow suppose that `content.md` does not exist in the same directory as this base file. What I'd like is a way to pass a set of paths to the CLI that informs the compiler that it should check each of those paths, in order, to attempt to find `content.md`, when the original lookup attempt fails to find a file.\r\n\r\n### Use Case\r\n\r\nThis makes it easy to re-use a Markdown snippet across many projects without keeping multiple copies of the snippet on disk. For example, suppose you have a \"legalese\" footer that you have to add to the bottom of each document you create. It would be great to have \"legalese.md\" in `~/Documents` and then simply use that file from anywhere by telling the MMD compiler to check `~/Documents` when it has trouble resolving a transcluded path.\r\n\r\nRight now, you've either got to copy \"legalese.md\" into multiple folders next to each base file that transcludes it, or you've got to worry about writing fragile relative paths between the base file and the location of the shared \"legalese.md\" file (and updating those paths when you move files around).\r\n\r\nThanks!"},"comment":{"url":"https://api.github.com/repos/fletcher/MultiMarkdown-4/issues/comments/94700677","html_url":"https://github.com/fletcher/MultiMarkdown-4/issues/112#issuecomment-94700677","issue_url":"https://api.github.com/repos/fletcher/MultiMarkdown-4/issues/112","id":94700677,"user":{"login":"mn4367","id":6379696,"avatar_url":"https://avatars.githubusercontent.com/u/6379696?v=3","gravatar_id":"","url":"https://api.github.com/users/mn4367","html_url":"https://github.com/mn4367","followers_url":"https://api.github.com/users/mn4367/followers","following_url":"https://api.github.com/users/mn4367/following{/other_user}","gists_url":"https://api.github.com/users/mn4367/gists{/gist_id}","starred_url":"https://api.github.com/users/mn4367/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mn4367/subscriptions","organizations_url":"https://api.github.com/users/mn4367/orgs","repos_url":"https://api.github.com/users/mn4367/repos","events_url":"https://api.github.com/users/mn4367/events{/privacy}","received_events_url":"https://api.github.com/users/mn4367/received_events","type":"User","site_admin":false},"created_at":"2015-04-21T08:26:03Z","updated_at":"2015-04-21T08:26:03Z","body":"There is already a [metadata key](http://fletcher.github.io/MultiMarkdown-4/transclusion.html) named `Transclude Base` which allows you to define a central path for such snippets. This key/path can be set in every document, so you could even create different folders for different document types (say letters, articles etc.)."}}