Interweaving two markdown files

Interweaving two markdown files

[Corentin Dupont]

[-- Attachment #1: Type: text/plain, Size: 1040 bytes --]

Hello,
I have two markdown files. The first contains a tutorial written in
markdown.
The second contains some questions/quizzes.

Example of tutorial file:

Arduino
======

An arduino is a microcontroller for developers.

Raspberry PI
==========
...


Example of quizz question file:

Arduino is a:
- Microcontroller
- Mini-PC

Raspberry is :
- ...


I'd rather keep the two separated, because sometimes I have to render the
tutorial, and the questions separately (say, for exams).
But I also need to render them interwoven, e.g. with the questions at the
end of each section.
How do you advice to do that?

Thanks

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/CAEyhvmp-ZYFczz7BgERWp3BskyXn3ttXGZ%2BO3SC53jVhLF7iqA%40mail.gmail.com.

[-- Attachment #2: Type: text/html, Size: 2282 bytes --]

AW: Interweaving two markdown files

[denis.maier-NSENcxR/0n0]

[-- Attachment #1: Type: text/plain, Size: 2398 bytes --]

Another approach : Keep the tutorial and the questions in the same file and use divs to mark-up the questions.

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
::: tutorial
Arduino
======

An arduino is a microcontroller for developers.
:::
::: quiz
Arduino is a:
- Microcontroller
- Mini-PC
:::
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

Then, use a filter to render one, the other or both.

Denis



Von: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org <pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org> Im Auftrag von Corentin Dupont
Gesendet: Mittwoch, 24. November 2021 11:59
An: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
Betreff: Interweaving two markdown files

Hello,
I have two markdown files. The first contains a tutorial written in markdown.
The second contains some questions/quizzes.

Example of tutorial file:

Arduino
======

An arduino is a microcontroller for developers.

Raspberry PI
==========
...


Example of quizz question file:

Arduino is a:
- Microcontroller
- Mini-PC

Raspberry is :
- ...


I'd rather keep the two separated, because sometimes I have to render the tutorial, and the questions separately (say, for exams).
But I also need to render them interwoven, e.g. with the questions at the end of each section.
How do you advice to do that?

Thanks

--
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org<mailto:pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>.
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/CAEyhvmp-ZYFczz7BgERWp3BskyXn3ttXGZ%2BO3SC53jVhLF7iqA%40mail.gmail.com<https://groups.google.com/d/msgid/pandoc-discuss/CAEyhvmp-ZYFczz7BgERWp3BskyXn3ttXGZ%2BO3SC53jVhLF7iqA%40mail.gmail.com?utm_medium=email&utm_source=footer>.

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/95fcb950a2ac46dd9b939dc39c74f4fa%40unibe.ch.

[-- Attachment #2: Type: text/html, Size: 9973 bytes --]

Re: Interweaving two markdown files

[Bastien DUMONT]

You can write both in a single file while using divs to discriminate beween them:

::: {.lesson}
Arduino
======

An arduino is a microcontroller for developers.

Raspberry PI
==========
...
:::

::: {.quizz}
Arduino is a:
- Microcontroller
- Mini-PC

Raspberry is :
- ...
:::

Then you can write a filter that suppresses Divs with class "lesson" and another one that suppresses those with class "quizz".

Le Wednesday 24 November 2021 à 11:58:48AM, Corentin Dupont a écrit :
> Hello,
> I have two markdown files. The first contains a tutorial written in markdown.
> The second contains some questions/quizzes.
> 
> Example of tutorial file:
> 
> Arduino
> ======
> 
> An arduino is a microcontroller for developers.
> 
> Raspberry PI
> ==========
> ...
> 
> 
> Example of quizz question file:
> 
> Arduino is a:
> - Microcontroller
> - Mini-PC
> 
> Raspberry is :
> - ...
> 
> 
> I'd rather keep the two separated, because sometimes I have to render the
> tutorial, and the questions separately (say, for exams).
> But I also need to render them interwoven, e.g. with the questions at the end
> of each section.
> How do you advice to do that?
> 
> Thanks
> 
> 
> --
> You received this message because you are subscribed to the Google Groups
> "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an email
> to [1]pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit [2]https://groups.google.com/d/msgid/
> pandoc-discuss/
> CAEyhvmp-ZYFczz7BgERWp3BskyXn3ttXGZ%2BO3SC53jVhLF7iqA%40mail.gmail.com.
> 
> References:
> 
> [1] mailto:pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
> [2] https://groups.google.com/d/msgid/pandoc-discuss/CAEyhvmp-ZYFczz7BgERWp3BskyXn3ttXGZ%2BO3SC53jVhLF7iqA%40mail.gmail.com?utm_medium=email&utm_source=footer

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/YZ4d1bz3N8ybLJlQ%40localhost.

Re: Interweaving two markdown files

[Corentin Dupont]

[-- Attachment #1: Type: text/plain, Size: 3460 bytes --]

Thanks for the responses. I didn't know that you could express divs in
markdown.

But is there any way to really keep the files separated? Maybe the simplest
way is to append the quizzes after the tutorials.

Another idea is to render the two files in two separate divs side by side,
and keep the divs in sync.

I'm using Hugo to generate the webpages, so using hugo templating system is
possible.


On Wed, Nov 24, 2021 at 12:12 PM Bastien DUMONT <bastien.dumont-VwIFZPTo/vqsTnJN9+BGXg@public.gmane.org>
wrote:

> You can write both in a single file while using divs to discriminate
> beween them:
>
> ::: {.lesson}
> Arduino
> ======
>
> An arduino is a microcontroller for developers.
>
> Raspberry PI
> ==========
> ...
> :::
>
> ::: {.quizz}
> Arduino is a:
> - Microcontroller
> - Mini-PC
>
> Raspberry is :
> - ...
> :::
>
> Then you can write a filter that suppresses Divs with class "lesson" and
> another one that suppresses those with class "quizz".
>
> Le Wednesday 24 November 2021 à 11:58:48AM, Corentin Dupont a écrit :
> > Hello,
> > I have two markdown files. The first contains a tutorial written in
> markdown.
> > The second contains some questions/quizzes.
> >
> > Example of tutorial file:
> >
> > Arduino
> > ======
> >
> > An arduino is a microcontroller for developers.
> >
> > Raspberry PI
> > ==========
> > ...
> >
> >
> > Example of quizz question file:
> >
> > Arduino is a:
> > - Microcontroller
> > - Mini-PC
> >
> > Raspberry is :
> > - ...
> >
> >
> > I'd rather keep the two separated, because sometimes I have to render the
> > tutorial, and the questions separately (say, for exams).
> > But I also need to render them interwoven, e.g. with the questions at
> the end
> > of each section.
> > How do you advice to do that?
> >
> > Thanks
> >
> >
> > --
> > You received this message because you are subscribed to the Google Groups
> > "pandoc-discuss" group.
> > To unsubscribe from this group and stop receiving emails from it, send
> an email
> > to [1]pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> > To view this discussion on the web visit [2]
> https://groups.google.com/d/msgid/
> > pandoc-discuss/
> > CAEyhvmp-ZYFczz7BgERWp3BskyXn3ttXGZ%2BO3SC53jVhLF7iqA%40mail.gmail.com.
> >
> > References:
> >
> > [1] mailto:pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
> > [2]
> https://groups.google.com/d/msgid/pandoc-discuss/CAEyhvmp-ZYFczz7BgERWp3BskyXn3ttXGZ%2BO3SC53jVhLF7iqA%40mail.gmail.com?utm_medium=email&utm_source=footer
>
> --
> You received this message because you are subscribed to the Google Groups
> "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/pandoc-discuss/YZ4d1bz3N8ybLJlQ%40localhost
> .
>

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/CAEyhvmpq4_8MXUtUX4hE6cQqEjdjjRbuP4-GBtyTQe70Xu3jdQ%40mail.gmail.com.

[-- Attachment #2: Type: text/html, Size: 5258 bytes --]

Re: Interweaving two markdown files

[Bastien DUMONT]

To concatenate them, simply write both on the command line: pandoc file1.md file2.md -o file.html. All other tasks would really be easier to achieve if you write alternated divs in a single source file.

Le Wednesday 24 November 2021 à 01:03:40PM, Corentin Dupont a écrit :
> Thanks for the responses. I didn't know that you could express divs in
> markdown.
> 
> But is there any way to really keep the files separated? Maybe the simplest way
> is to append the quizzes after the tutorials.
> 
> Another idea is to render the two files in two separate divs side by side, and
> keep the divs in sync.
> 
> I'm using Hugo to generate the webpages, so using hugo templating system is
> possible.
> 
> 
> On Wed, Nov 24, 2021 at 12:12 PM Bastien DUMONT <[1]bastien.dumont@posteo.net>
> wrote:
> 
>     You can write both in a single file while using divs to discriminate beween
>     them:
> 
>     ::: {.lesson}
>     Arduino
>     ======
> 
>     An arduino is a microcontroller for developers.
> 
>     Raspberry PI
>     ==========
>     ...
>     :::
> 
>     ::: {.quizz}
>     Arduino is a:
>     - Microcontroller
>     - Mini-PC
> 
>     Raspberry is :
>     - ...
>     :::
> 
>     Then you can write a filter that suppresses Divs with class "lesson" and
>     another one that suppresses those with class "quizz".
> 
>     Le Wednesday 24 November 2021 à 11:58:48AM, Corentin Dupont a écrit :
>     > Hello,
>     > I have two markdown files. The first contains a tutorial written in
>     markdown.
>     > The second contains some questions/quizzes.
>     >
>     > Example of tutorial file:
>     >
>     > Arduino
>     > ======
>     >
>     > An arduino is a microcontroller for developers.
>     >
>     > Raspberry PI
>     > ==========
>     > ...
>     >
>     >
>     > Example of quizz question file:
>     >
>     > Arduino is a:
>     > - Microcontroller
>     > - Mini-PC
>     >
>     > Raspberry is :
>     > - ...
>     >
>     >
>     > I'd rather keep the two separated, because sometimes I have to render the
>     > tutorial, and the questions separately (say, for exams).
>     > But I also need to render them interwoven, e.g. with the questions at the
>     end
>     > of each section.
>     > How do you advice to do that?
>     >
>     > Thanks
>     >
>     >
>     > --
>     > You received this message because you are subscribed to the Google Groups
>     > "pandoc-discuss" group.
>     > To unsubscribe from this group and stop receiving emails from it, send an
>     email
>     > to [1][2]pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>     > To view this discussion on the web visit [2][3]https://groups.google.com/
>     d/msgid/
>     > pandoc-discuss/
>     > CAEyhvmp-ZYFczz7BgERWp3BskyXn3ttXGZ%2BO3SC53jVhLF7iqA%[4]40mail.gmail.com
>     .
>     >
>     > References:
>     >
>     > [1] mailto:[5]pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
>     > [2] [6]https://groups.google.com/d/msgid/pandoc-discuss/
>     CAEyhvmp-ZYFczz7BgERWp3BskyXn3ttXGZ%2BO3SC53jVhLF7iqA%40mail.gmail.com?
>     utm_medium=email&utm_source=footer
> 
>     --
>     You received this message because you are subscribed to the Google Groups
>     "pandoc-discuss" group.
>     To unsubscribe from this group and stop receiving emails from it, send an
>     email to [7]pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>     To view this discussion on the web visit [8]https://groups.google.com/d/
>     msgid/pandoc-discuss/YZ4d1bz3N8ybLJlQ%40localhost.
> 
> --
> You received this message because you are subscribed to the Google Groups
> "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an email
> to [9]pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit [10]https://groups.google.com/d/msgid/
> pandoc-discuss/
> CAEyhvmpq4_8MXUtUX4hE6cQqEjdjjRbuP4-GBtyTQe70Xu3jdQ%40mail.gmail.com.
> 
> References:
> 
> [1] mailto:bastien.dumont-VwIFZPTo/vqsTnJN9+BGXg@public.gmane.org
> [2] mailto:pandoc-discuss%2Bunsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
> [3] https://groups.google.com/d/msgid/
> [4] http://40mail.gmail.com/
> [5] mailto:pandoc-discuss%2Bunsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
> [6] https://groups.google.com/d/msgid/pandoc-discuss/CAEyhvmp-ZYFczz7BgERWp3BskyXn3ttXGZ%2BO3SC53jVhLF7iqA%40mail.gmail.com?utm_medium=email&utm_source=footer
> [7] mailto:pandoc-discuss%2Bunsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
> [8] https://groups.google.com/d/msgid/pandoc-discuss/YZ4d1bz3N8ybLJlQ%40localhost
> [9] mailto:pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
> [10] https://groups.google.com/d/msgid/pandoc-discuss/CAEyhvmpq4_8MXUtUX4hE6cQqEjdjjRbuP4-GBtyTQe70Xu3jdQ%40mail.gmail.com?utm_medium=email&utm_source=footer

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/YZ49AaDj088nEmi5%40localhost.

AW: Interweaving two markdown files

[denis.maier-NSENcxR/0n0]

[-- Attachment #1: Type: text/plain, Size: 4834 bytes --]



Von: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org <pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org> Im Auftrag von Corentin Dupont
Gesendet: Mittwoch, 24. November 2021 13:04
An: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
Betreff: Re: Interweaving two markdown files

Thanks for the responses. I didn't know that you could express divs in markdown.


Well, it’s a pandoc extension.



But is there any way to really keep the files separated? Maybe the simplest way is to append the quizzes after the tutorials.


You mean in the input, or in the output?
In the output it’s possible with a filter.
Merging two files is a bit more involved if you really want to interweave the files. If all you want is appending, you can simply call pandoc with multiple files.

pandoc OPTIONS tutorial.md quiz.md



Another idea is to render the two files in two separate divs side by side, and keep the divs in sync.

I'm using Hugo to generate the webpages, so using hugo templating system is possible.


On Wed, Nov 24, 2021 at 12:12 PM Bastien DUMONT <bastien.dumont-VwIFZPTo/vqsTnJN9+BGXg@public.gmane.org<mailto:bastien.dumont-VwIFZPTo/vqsTnJN9+BGXg@public.gmane.org>> wrote:
You can write both in a single file while using divs to discriminate beween them:

::: {.lesson}
Arduino
======

An arduino is a microcontroller for developers.

Raspberry PI
==========
...
:::

::: {.quizz}
Arduino is a:
- Microcontroller
- Mini-PC

Raspberry is :
- ...
:::

Then you can write a filter that suppresses Divs with class "lesson" and another one that suppresses those with class "quizz".

Le Wednesday 24 November 2021 à 11:58:48AM, Corentin Dupont a écrit :
> Hello,
> I have two markdown files. The first contains a tutorial written in markdown.
> The second contains some questions/quizzes.
>
> Example of tutorial file:
>
> Arduino
> ======
>
> An arduino is a microcontroller for developers.
>
> Raspberry PI
> ==========
> ...
>
>
> Example of quizz question file:
>
> Arduino is a:
> - Microcontroller
> - Mini-PC
>
> Raspberry is :
> - ...
>
>
> I'd rather keep the two separated, because sometimes I have to render the
> tutorial, and the questions separately (say, for exams).
> But I also need to render them interwoven, e.g. with the questions at the end
> of each section.
> How do you advice to do that?
>
> Thanks
>
>
> --
> You received this message because you are subscribed to the Google Groups
> "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an email
> to [1]pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org<mailto:pandoc-discuss%2Bunsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>.
> To view this discussion on the web visit [2]https://groups.google.com/d/msgid/
> pandoc-discuss/
> CAEyhvmp-ZYFczz7BgERWp3BskyXn3ttXGZ%2BO3SC53jVhLF7iqA%40mail.gmail.com<http://40mail.gmail.com>.
>
> References:
>
> [1] mailto:pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org<mailto:pandoc-discuss%2Bunsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>
> [2] https://groups.google.com/d/msgid/pandoc-discuss/CAEyhvmp-ZYFczz7BgERWp3BskyXn3ttXGZ%2BO3SC53jVhLF7iqA%40mail.gmail.com?utm_medium=email&utm_source=footer

--
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org<mailto:pandoc-discuss%2Bunsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>.
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/YZ4d1bz3N8ybLJlQ%40localhost.
--
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org<mailto:pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>.
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/CAEyhvmpq4_8MXUtUX4hE6cQqEjdjjRbuP4-GBtyTQe70Xu3jdQ%40mail.gmail.com<https://groups.google.com/d/msgid/pandoc-discuss/CAEyhvmpq4_8MXUtUX4hE6cQqEjdjjRbuP4-GBtyTQe70Xu3jdQ%40mail.gmail.com?utm_medium=email&utm_source=footer>.

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/f8a2af25b16c4d978c2e2df305340542%40unibe.ch.

[-- Attachment #2: Type: text/html, Size: 9825 bytes --]

Re: Interweaving two markdown files

[Daniel Staal]

On 11/24/21 5:58 AM, Corentin Dupont wrote:
> Hello,
> I have two markdown files. The first contains a tutorial written in 
> markdown.
> The second contains some questions/quizzes.

> I'd rather keep the two separated, because sometimes I have to render 
> the tutorial, and the questions separately (say, for exams).
> But I also need to render them interwoven, e.g. with the questions at 
> the end of each section.
> How do you advice to do that?

My thought would be to break it into chapters - have one chapter per 
file, with separate folders for text and quiz chapter files.

Then when you want to just have one or the other, you render only that 
folder.  If you want both, you can render both folders together. 
(Probably with a makefile or similar.)

Daniel T. Staal

-- 
---------------------------------------------------------------
This email copyright the author.  Unless otherwise noted, you
are expressly allowed to retransmit, quote, or otherwise use
the contents for non-commercial purposes.  This copyright will
expire 5 years after the author's death, or in 30 years,
whichever is longer, unless such a period is in excess of
local copyright law.
---------------------------------------------------------------