Re: Own documentation in django

Hello chetan,

I know django very much also aaciidoc. Problem is that asciidoc have cool features like automatic create TOC or count Images and tables an further more but uf you want to create a template for a include where i render a Image then you can only use veriables in this template very laborious. Includes in tables don't work in tables good. So i search for a dicumentation system like asciidoc with much more features where i can for exampke create a template like in django and submit a json context which i can ussr in template. And also jinja2 or similar with so much features...

Chetan Ganji <ganji.chetan@gmail.com> schrieb am Fr., 14. Juli 2023, 21:00:

I am little confused right now.
You have said markdown and jinja templates (reusing them also)

markdown is used for documentation procedures. Jinja is used for actual html templates. 
I am not sure what you want to achieve!

For code reuse you can use template inheritance.
When you pass diff context to diff templates that are extending from the same base template;
(e.g. template1.html and template2.html are using table.html)
you can reuse html templates with different content.
https://docs.djangoproject.com/en/4.2/ref/templates/language/#template-inheritance

Regards,

Chetan Ganji

+91-900-483-4183

ganji.chetan@gmail.com

http://ryucoder.in

On Fri, Jul 14, 2023 at 6:53 PM sebasti...@gmail.com <sebastian.jung2@gmail.com> wrote:

Hello,

i use regular markdown and asciidoc. Problem is that both have to less feature. For example i want to reuse html templates with different content.

In asciidoc i can do this following:

i declare variables

:varibale1: Teststring

:variable2: Second String

include::buttontemplate.adoc[]

This is not good in reading such source code. Second thing include i can't use inline only in new line and i have problems to make include in tables.

Asciidoc have no multilanguage suppport. And further more problems

So i think for very small documumentation asciidoc is wunderfull but for greater docus with several levels in TOC and multilanguage this tool is to unflexible. Does anyone knows a package in django where i have a syntax like asciidoc/markdown but the felxibility like in django where a can use jinja2 and can use templating and multilanguage works?

Regards

--
You received this message because you are subscribed to the Google Groups "Django users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to django-users+unsubscribe@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/django-users/a2c07298-a2e7-4a8f-ab2e-79367a2b5dcdn%40googlegroups.com.

--
You received this message because you are subscribed to the Google Groups "Django users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to django-users+unsubscribe@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/django-users/CAMKMUju%3DzCa1ehbLHQKddOPTRfLyOrAi4FqNowhnFTXX2isJyQ%40mail.gmail.com.

--
You received this message because you are subscribed to the Google Groups "Django users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to django-users+unsubscribe@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/django-users/CAKGT9mzupZ6XRnROjvPgv8N-kykOgaBUjBt%2B0TMTky2a-Qt%2BVQ%40mail.gmail.com.