JuliaDocs/Franklin.jl

API documentation

Open

#810 opened on 2021年4月5日

GitHub で見る
 (6 comments) (1 reaction) (0 assignees)Julia (118 forks)batch import
docsgood first issuehelp wanted

Repository metrics

Stars
 (1,060 stars)
PR merge metrics
 (平均マージ 71d 9h) (30d で 4 merged PRs)

説明

As noted on slack, I've run into a couple of road-blocks when exploring some features. Noting them here for posterity:

  • on this page, there's an example block with {{ispage blog/*}} {{insert head_blog}}{{end}}. ispage has some documentation here, but I can't find where insert is documented.
  • Similarly, things like {{fill x}} here aren't super clear, but I can't find other documentation.
  • Separately, I found the function in the julialang.org utils.jl file to generate blogposts, and they use the pagevar function, which I can't find on the docs page, but which does have a docstring from the REPL

To quote tlienart:

Thanks, feel free to list these points in an issue, so we can chip at it gradually :slightly_smiling_face: Just quickly in case this is blocking you now:

  • insert inserts anything "as is" in HTML taking as base path the _layout/ folder
  • fill inserts the content of a page variable, shortcut {{x}} is the same as {{fill x}} if x is un-ambiguous (i.e. there is no hfun_x )
  • pagevar is to get a page variable from a page that is different from the current one it works as pagevar(rpath, name) where rpath is the path of the other page like blog/foo/bar.md and name is the name of the page variable defined there that you'd want to include.

コントリビューターガイド