ideas for project setup ?

[vc64web]

ideas for project setup ?

[mithrendal]

to try out github pages I followed the advice of @sy2002 and actived it in the settings like he said. I had to fork the repo though to try this out because I can not go into the settings of this repo to activate because dirk is the owner ;-)

as a test it works very well see here ...

https://mithrendal.github.io/virtualc64web/vC64.html

just drag the 4 rom files into the vc1541 .... and it will copy them to local storage for subsequent visits to the site ...

@dirkwhoffmann I think we should activate github pages in this repo ... what do you think ... how do we organise this ... a special branch maybe like sy2002 said ?

[dirkwhoffmann]

gh-pages branch up and running 😎:

[mithrendal]

I did go with make publish command into the gh-pages branch approach

now it starts up when you call

https://dirkwhoffmann.github.io/virtualc64web/

be sure to put it onto your iPhones homescreen 😍

[dirkwhoffmann]

https://dirkwhoffmann.github.io/virtualc64web/

Works like a charm. Very cool 😎.

[dirkwhoffmann]

Because I think we need to have the history of patches I already have applied

That all sounds good to me. 👍

I thought about deployment. Github supports GitHub Pages which is essentially source control for HTML pages. Using GitHub Pages for this repo, we could perhaps deploy the web version directly from here. 🤔

[mithrendal]

I thought about deployment. Github supports GitHub Pages which is essentially source control for HTML pages. Using GitHub Pages for this repo, we could perhaps deploy the web version directly from here.

Oh yes, that could work 🤓... when it allows us to upload .wasm .js and .data files.

[sy2002]

@mithrendal and @dirkwhoffmann Gentlemen, first of all congrats to this really cool project! :-)

About this:

Oh yes, that could work 🤓... when it allows us to upload .wasm .js and .data files.

Yes, you can use GitHub Pages to serve WebAssembly apps. I am actually using GitHub Pages including the built-in Jekyll static site builder to host my own WebAssembly/WebGL Emscripten app.

For using GitHub Pages Just create a branch called "gh-pages" in your repo and check-in the .wasm, .js and .data files there. Activate the branch in the repo's "GitHub Pages" settings and you are done.

Also, just in case you haven't seen this one, yet and as soon as you want to experiment with your own "GUI": This minimal Emscripten Shell file (link) is a better starting point for creating your own GUI than the bloated standard Emscripten shell and you can add it to your build using the --shell-file option in emcc.

[mithrendal]

Hi sy2002,

thanks for your feedback it is very welcomed ... 😊

Yes, you can use GitHub Pages to serve WebAssembly apps. I am actually using GitHub Pages including the built-in Jekyll static site builder to host my own WebAssembly/WebGL Emscripten app.

Thats sounds pretty cool.😎 We should definitely evaluate that ...

you can add it to your build using the --shell-file

Thanks for the hint 😍!!! Thats exactly what I already did, it is just not yet in the master, head to the dev branch for a review. Although I am still learning about gnu-makefiles, I think I achieved some optimisations to it ... e.g. all the object files are generated now in a dedicated "obj" folder...

I am currently struggeling at the fullscreen topic.🧟‍♀️ (not commited/pushed in yet) Rendering directly via surface with manual pixel modification works fine. The render texture thing still gives me headaches😷... see here make fullscreen work

[sy2002]

Just a small sidenote: Normally you would empty the gh-pages branch completely and just add the files necessary for Jekyll and other web contents. Currently your gh-pages branch seems to be fully crowded and a clone of main or dev. Here is an example of what I mean by "empty" and "just web and Jekyll stuff" :-)

[mithrendal]

Normally you would empty the gh-pages branch completely and just add the files necessary for Jekyll and other web contents.

Oh yeah ... whats jekyll ? ... hang on I am looking into the Jekyll stuff ...
...
this is only a preprocessor to generate html from md files right ? I am not sure whether we need this right now... maybe when we later would do some blogs or so ? ... or does this Jekyll thing do something more ? ...

In fact super cool would be an automatic builder, which builds the gh-pages branch contents when for example branch dev receives a push ... @dirkwhoffmann is this done with the travis thing ?

otherwise I just read that github has the option to only make master/docs folder the root of the github pages site...

hmmm ... what is the "normal" workflow for publishing to gh pages ?
1.you do some changes to for example branch dev
2.you make a pull request from dev to gh-pages ?
-> no can not be .... because it would result in merging all the source code into gh-pages

maybe I still don't get the meaning of this special gh-pages branch ... there must be something more magic in it right ?

[mithrendal]

your gh-pages branch seems to be fully crowded and a clone of main or dev

I can only see this two solutions ...

we add a "publish" target to the makefile

make publish

this would then only copy all necessary files to run VirtualC64web into the /docs folder ...

then we had to alter the github pages of this repo to

but maybe there is some more magic in the gh-pages branch which I don't see at the moment ?

Or another approach would be to delete all the stuff in gh-pages branch and clone it parallel to the for example branch /dev

cd .../some_workspace
git clone -b dev blablabablabla 64dev
and
git clone -b gh-pages blablabablabla gh-pages

this would result in
/some_workspace/64dev
/some_workspace/gh-pages

we could alter the "publish" command in the makefile in 64dev that it copies the necessary files to the gh-pages branch ...

cd /some_workspace/64dev
make publish

this would copy the the necessary files to the gh-pages branch

then with

cd /some_workspace/gh-pages
git commit
git push 

we could update the gh-pages branch ...

any thoughts ?