Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

create folder to house jinja templates #10

Open
sujaypatil96 opened this issue Sep 15, 2022 · 2 comments
Open

create folder to house jinja templates #10

sujaypatil96 opened this issue Sep 15, 2022 · 2 comments
Assignees

Comments

@sujaypatil96
Copy link
Member

Create a folder called doc-templates in the src folder to house the base jinja templates that the first pass project created by cookiecutter can depend on.

The folder will contain all the files from here: https://github.com/linkml/linkml/tree/main/linkml/generators/docgen

The reason why this is useful is because users would no longer have to go to the above location to fish out starter jinja templates to begin modifying the style and content of their web documentation pages.

@turbomam
Copy link

Should this solution also include providing a Makefile rule for generating documentation pages with --template-directory doc-templates

would need a different name from gendoc

@sujaypatil96
Copy link
Member Author

Decide if this is still the best way forward. Close it out if not.

Caveats:

  • We can't have an empty doc-templates folder (on GitHub)
  • Shouldn't confuse users/developers by exposing more files in src

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants