ralexander-phi / marp-to-pages Goto Github PK

Thanks for this great resource. This is the easiest to understand marp to pages guide I've found.

I used your template, but on the first build the slides did not render correctly (even after point to gh-pages as the branch to build from). Instead of a formatted slide view I was getting flat HTML content. The problem seemed to be solved by adding a .nojekyll file to the root.

I'm a bit puzzled as to why you didn't seem to need one (maybe some github setting accomplishes the same?). But I thought I'd mention the issue here in case this affects anyone else.

If I remove the images directory the workflow fails because it cannot find the images to copy.
I think the same applies to the docs directory.
The workflow must work on img and docs directories only if they exist and have some content.

NOTE: I noticed that your original action had been deprecated, so I thought I would re-ask the question here:

This action looks like it will be really useful, so thank you very much for creating it!

I was a long time user of GitPitch before it closed down, and I am looking to see whether I can use Marp as a replacement.

The way I used to create my GitPitch decks was that I would work off of the master/main branch, and once I gave a presentation I would create a branch at the point that I gave the talk, so that anyone who wanted to review the slide deck for that version of the talk could go back and look at it, and I could continue to tweak/change the slide deck on the master branch.

An example of this can be found here:

https://github.com/gep13-talks/CakeDemos

Is it possible for this action to support the creation of multiple folders in the site that is published to GitHub pages? i.e. a folder for each branch, and then I could give folks a link to the folder to view that version of the slide deck.

Thanks for any help that you can offer here!

Currently, the example suggests building slides locally prior to opening a PR.

It will be great to take advantage of GitHub Actions to automatically build preview slides with the changes that PRs introduce. I think is something that everyone will be willing to use.

Is marp-action capable of doing this? I assume that some configuration must be added to .github/workflows/main.yml, but I do not know GitHub Actions.

Does it seem like the html tags and the background images defined in inline css don't work in the gh-page deploy?

I have deployed the page from the root folder /, and the md file is located in /docs/ folder, while the images are located in the /img/ folder. I have also tried to deploy the /docs/ folder, but it still doesn't work.

I have set the following line for the background images like the following.

marp: true
author: 
header: ''
theme: gaia
math: katex
paginate: true
style: |
    :root {
        background-image: url("./img/background.jpg");
        background-size: contain;
        padding: 3rem;
    }

Besides, I have used some html tags like <p>, <span> and <small> in the md file, both the tags and the image shows correctly in the vscode editor, but it doesn't work when deploying on the gh-page.

After creating a repo from your template repo I need to make an additional step:
Go to Settings > Actions > General > in Workflow permissions select Read and Write permissions.
This is required by https://github.com/JamesIves/github-pages-deploy-action and because you use this action it is worth mentioning.

One nitpick is to have the setup procedure in steps not in subtitles for readability.

Thank you

See #10. Find a way to document these or make these defaults.