demo icon indicating copy to clipboard operation
demo copied to clipboard

Add manual build and deploy to help learning experience

Open oscar6echo opened this issue 1 year ago • 4 comments

As a user, I would rather not jump directly to full automation - with GA.
Instead, I am much more interested to go step by step, and only when full understood, use magical automation.

Somebody who wants to create a custom jupytelite may start from there and iterate/change the repo to fine tune their specifics.
Then the deploy script is so fast that in many cases it is a good option to just run it - like you would run say a "git push --tags".

Hope this helps.

oscar6echo avatar May 16 '23 21:05 oscar6echo

btw maybe there could be a refenrece to the official doc to indicate this step by step deploy approach.

oscar6echo avatar May 16 '23 21:05 oscar6echo

I like this... I've found that customizing jupyterlite for embedding in Quepid has been daunting at times... A lot of concepts to engage with!

epugh avatar May 16 '23 23:05 epugh

btw maybe there could be a refenrece to the official doc to indicate this step by step deploy approach.

I think that was the intent of this guide: https://jupyterlite.readthedocs.io/en/latest/quickstart/standalone.html

Otherwise maybe there could be a new guide under this section called "Deploy to GitHub Pages manually": https://jupyterlite.readthedocs.io/en/latest/howto/index.html#deploying

Note there is also this tutorial I was hoping to contribute some parts of it to the main docs: https://pyconde2023-jupyterlite.readthedocs.io/en/latest/tutorial.html

jtpio avatar May 17 '23 06:05 jtpio

I think that was the intent of this guide: https://jupyterlite.readthedocs.io/en/latest/quickstart/standalone.html

Otherwise maybe there could be a new guide under this section called "Deploy to GitHub Pages manually": https://jupyterlite.readthedocs.io/en/latest/howto/index.html#deploying

I agree this step by step "local first" guide may be available in several places and shapes. I have no strong opinion about it.

In my mind this PR is not necessarily meant to be merged, rather to show how a user - like me, but I cannot be that special - would go about trying jupyterlite beyond the initial demo effect provided by the full automatic process. There is nothing like running commands in terminal, watching the effects, adjust, all the way to deployment. This is all the more true for a static site which can easily be tweaked before deploy.

If you prefer taking pieces of it, or just the genral idea to write it differently, this is 100% fine with me.

(But writing it as a PR enabled me to test it)

oscar6echo avatar May 17 '23 08:05 oscar6echo