search

foliant-docs / foliant

Comprehensive markdown-based documentation toolkit
https://foliant-docs.github.io/docs/
MIT License
158 stars 9 forks source link

Pulling a single file from a big remote repository #29

Open artlomov opened 6 years ago

artlomov commented 6 years ago

It’s often required to include the content of a single file from remote repository into a document. The repo can contain a lot of files, and the files can be large.

When we use built-in includes, the source repository will be fully cloned, as far as I know:

{{ <git@github.com:foliant-docs/foliant.git>README.md }}

It seems useful to get an optional possibility to pull certain files from big remote repositories by using commands like this:

$ git archive --remote=git@github.com:foliant-docs/foliant.git HEAD README.md | tar -xO > ./README.md