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

Add a static CONTRIBUTING.md template #27

Merged
merged 6 commits into from
Sep 18, 2021
Merged

Conversation

abravalheri
Copy link
Contributor

This is an alternative implementation to address #18, while the issues with rst-to-myst still persist.

The template was generated by automatically converting PyScaffold's original RST templating via rst-to-myst CLI and then manually adjusting/improving it.

rst2myst stream ~/projects/pyscaffold/src/pyscaffold/templates/contributing.template \
    > src/pyscaffoldext/markdown/templates/contributing.template

For some mysterious reason, I did not manage to make Jinja2 substitutions even when the substitution myst extension is active in conf.py (which is very curious because it is working fine in the example I create when I opened the issue in rst-to-myst - see expected_option1.md)

The code in this PR is based on #25.

The template was generated by automatically converting PyScaffold's
original RST templating via [rst-to-myst]

```
rst2myst stream ~/projects/pyscaffold/src/pyscaffold/templates/contributing.template > src/pyscaffoldext/markdown/templates/contributing.template
```

and then manually adjusting the Jinja2 replacements.

[rst-to-myst]: https://pypi.org/projects/rst-to-myst
Due to an [issue] the output generated by rst-to-myst does not work 100%.
Therefore a fixed template seems to be a temporary solution.

[issue]: executablebooks/rst-to-myst#33
For some reason Jinja2 substitutions don't seem to work when rendering
the markdown templates even when the myst extension is active.

This change improves the template having that concern in mind.
@abravalheri abravalheri changed the title Issue 18 alternative Add a static CONTRIBUTING.md template Sep 18, 2021
@FlorianWilhelm
Copy link
Member

Thanks @abravalheri! I think that's perfect for the time being and the implementation is much easier.

@FlorianWilhelm FlorianWilhelm merged commit 5de33f5 into master Sep 18, 2021
@FlorianWilhelm FlorianWilhelm deleted the issue-18-alternative branch September 18, 2021 18:51
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

Successfully merging this pull request may close these issues.

2 participants