[RFC] Download as PDF about primer-spec

[awdeorio]

This is a tricky problem.

I'm not super excited about the overhead of adding a GitHub action for Option 3. It will certainly generate Git merge conflicts when multiple branches update the spec. This problem is similar to the starter files tarball problem and most people (including instructors) are helpless when it comes to resolving merge conflicts.

I kinda like Option 1 despite its limitations.

[seshrs]

Update: I am one step closer to making this a reality! 😃

Now that GitHub Pages can be deployed via GitHub Actions, we can run arbitrary commands to generate static files. I created a custom action to build Primer Spec (see #212).

For the past month, I've been playing around trying to get dynamic PDF generation to work. Thanks to amazing support from GitHub's Support team, I have a working prototype!

• GitHub Action: https://github.com/seshrs/build-primer-spec-action/blob/48edf3da1472a337b3c827a3de198646901bafdd/action.yml#L24-L51
• Example page: https://seshrs.github.io/ci-playground/nested-dir/nested-spec-test.html
• Corresponding PDF: https://seshrs.github.io/ci-playground/assets/primer-spec-pdf/nested-dir/nested-spec-test.pdf

Now, all that's left is to figure out how to create a UI in Primer Spec to link students to the PDF. I'll need some time to explore UIs (and maybe correspond with @bellakiminsun) — meanwhile, I'd welcome suggestions and design proposals from anyone 😄

[bellakiminsun]

Yay for pdfs 🎉🎉🎉🎉 2022년 10월 21일 (금) 오후 11:37, Sesh Sadasivam ***@***.***>님이 작성:

…

Update: I am one step closer to making this a reality! 😃 Now that GitHub Pages can be deployed via GitHub Actions, we can run arbitrary commands to generate static files. I created a custom action <https://github.com/seshrs/build-primer-spec-action> to build Primer Spec (see #212 <#212>). For the past month, I've been playing around trying to get dynamic PDF generation to work. Thanks to amazing support from GitHub's Support team, I have a working prototype! - GitHub Action: https://github.com/seshrs/build-primer-spec-action/blob/48edf3da1472a337b3c827a3de198646901bafdd/action.yml#L24-L51 - Example page: https://seshrs.github.io/ci-playground/nested-dir/nested-spec-test.html - Corresponding PDF: https://seshrs.github.io/ci-playground/assets/primer-spec-pdf/nested-dir/nested-spec-test.pdf Now, all that's left is to figure out how to create a UI in Primer Spec to link students to the PDF. I'll need some time to explore UIs (and maybe correspond with @bellakiminsun <https://github.com/bellakiminsun>) — meanwhile, I'd welcome suggestions and design proposals from anyone 😄 — Reply to this email directly, view it on GitHub <#136 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AFQ2TWVMXCUUIUBJFJGFKZDWEODQ3ANCNFSM5HUHHY7A> . You are receiving this because you were mentioned.Message ID: ***@***.***>