{"action":"created","issue":{"url":"https://api.github.com/repos/MichaelHatherly/Docile.jl/issues/102","labels_url":"https://api.github.com/repos/MichaelHatherly/Docile.jl/issues/102/labels{/name}","comments_url":"https://api.github.com/repos/MichaelHatherly/Docile.jl/issues/102/comments","events_url":"https://api.github.com/repos/MichaelHatherly/Docile.jl/issues/102/events","html_url":"https://github.com/MichaelHatherly/Docile.jl/issues/102","id":74903248,"number":102,"title":"Proposal: Make $(metaname) part of Docile parseing ","user":{"login":"peter1000","id":6168860,"avatar_url":"https://avatars.githubusercontent.com/u/6168860?v=3","gravatar_id":"","url":"https://api.github.com/users/peter1000","html_url":"https://github.com/peter1000","followers_url":"https://api.github.com/users/peter1000/followers","following_url":"https://api.github.com/users/peter1000/following{/other_user}","gists_url":"https://api.github.com/users/peter1000/gists{/gist_id}","starred_url":"https://api.github.com/users/peter1000/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/peter1000/subscriptions","organizations_url":"https://api.github.com/users/peter1000/orgs","repos_url":"https://api.github.com/users/peter1000/repos","events_url":"https://api.github.com/users/peter1000/events{/privacy}","received_events_url":"https://api.github.com/users/peter1000/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/MichaelHatherly/Docile.jl/labels/speculative","name":"speculative","color":"bfdadc"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":5,"created_at":"2015-05-10T11:47:55Z","updated_at":"2015-05-10T12:31:17Z","closed_at":null,"body":"come from discussion [here](https://github.com/MichaelHatherly/Docile.jl/issues/89#issuecomment-100619325)\r\n\r\nI propose that: `$(metaname)` should be resolved within Dociles parseing process.\r\n\r\nDifferent than `!!new_meta(New Meta Value)` this would allow any available metadata to be interpolated into the documentation: similar to julias string interpolation.\r\n\r\n* `!!new_meta(Outer New Meta Value)`  raises error if an other `!!new_meta(Inner New Meta Value)` is within: THIS IS ERROR\r\n\r\n  ```\r\n  \"\"\"\r\n  !!site_author(Michael Hatherly)\r\n  !!copyright((c) !!site_author() and other contributors.)\r\n  \"\"\"\r\n  ```\r\n\r\n* Empty `!!new_meta()` is also an error\r\n\r\n* Correct: \r\n\r\n  ```\r\n  \"\"\"\r\n  !!site_author(Michael Hatherly)\r\n  !!copyright((c) $(site_author) and other contributors.)\r\n  \"\"\"\r\n  ```\r\n\r\n---\r\n\r\nAdvantages: \r\n\r\n* It does not seem to be introducing a whole lot of new things to learn: as such interpolation is an integrated part of julia anyway.\r\n\r\n* It makes a clear destinction between `adding metadata` and `interpolation`\r\n\r\n* It also seems more natural to julia user than the *empty* `!!replaceme()` one.\r\n  Maybe this would be a better `$(replaceme)`option to use.\r\n\r\n**BIG question:** how are the different available metas resolved: not sure\r\n\r\n* First within the docstring (obj) itself\r\n* Not found: previously added to the module\r\n* Not found: package (this seems to include the  new `.docile` config settings)\r\n* Not found: [multi package - project_meta](https://github.com/MichaelHatherly/Docile.jl/issues/89#issuecomment-100623269)\r\n\r\n\r\n"},"comment":{"url":"https://api.github.com/repos/MichaelHatherly/Docile.jl/issues/comments/100633520","html_url":"https://github.com/MichaelHatherly/Docile.jl/issues/102#issuecomment-100633520","issue_url":"https://api.github.com/repos/MichaelHatherly/Docile.jl/issues/102","id":100633520,"user":{"login":"peter1000","id":6168860,"avatar_url":"https://avatars.githubusercontent.com/u/6168860?v=3","gravatar_id":"","url":"https://api.github.com/users/peter1000","html_url":"https://github.com/peter1000","followers_url":"https://api.github.com/users/peter1000/followers","following_url":"https://api.github.com/users/peter1000/following{/other_user}","gists_url":"https://api.github.com/users/peter1000/gists{/gist_id}","starred_url":"https://api.github.com/users/peter1000/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/peter1000/subscriptions","organizations_url":"https://api.github.com/users/peter1000/orgs","repos_url":"https://api.github.com/users/peter1000/repos","events_url":"https://api.github.com/users/peter1000/events{/privacy}","received_events_url":"https://api.github.com/users/peter1000/received_events","type":"User","site_admin":false},"created_at":"2015-05-10T12:31:17Z","updated_at":"2015-05-10T12:31:17Z","body":"> . $ also clashes ....\r\n\r\nI think anything would be open for usage just thought that $ would seem most natural to julia user.\r\n\r\nCheers"}}