In your newly opened Jupyter Lab click on the “Python three” field below the “Pocket book” header. This could create a brand new Untitled.ipynb file and open it for you. From this new file you possibly can write and run your Python code in code cells and add titles and descriptions in markdown cells.
Within the above image you will notice that I’ve created two cells. The primary cell is a Markdown Title cell the place I’ve added the title “My Venture Web site” that can seem as a title as a result of I put the “#” earlier than the phrases. Operating that cell will produce a properly formatted title. Beneath that cell I created a code cell that merely prints “hi there world”. Saving that file with no matter title you select will conclude the creating of our Jupyter Pocket book for this demo. See my undertaking hyperlinks at first of this text for examples of extra superior logic you can add to your pocket book sooner or later.
In our open Jupyter Lab tab go to: File → Export Pocket book As… → Export Pocket book to HTML. It will obtain an HTML file with the identical title as your ipynb file.
As soon as now we have this file downloaded you need to transfer it into your repository and ensure you rename the file: index.html
In your terminal or git bash window — ensure you are in your Git repository. Then we must always run this command to pick out all up to date recordsdata in our repository to be dedicated:
git add .
Subsequent, we’ll run this command to commit all of our modified recordsdata with a helpful message:
git commit -m "Added undertaking pocket book and undertaking index.html file"
Lastly we are able to push it up utilizing this command:
If we go to our GitHub repository after this we must always see:
*If you happen to by chance dedicated a “.DS_Store” file — don’t be afraid and simply ignore it. It’s a non permanent file that you may delete later.
Again in our GitHub repository on-line we’ll click on the “Settings” button that’s the final possibility within the toolbar below the “Username/Repository Identify” hyperlink on the prime of the web page.
On the next Settings web page — scroll all the way down to the “GitHub Pages” part of the “Choices” menu. It’s best to see a “Supply” header — and under drop-down menu with the default possibility “None” chosen.
Choose “grasp department” from the drop-down menu and that can refresh your Settings web page. Scrolling again all the way down to the “GitHub Pages” part ought to now present you this message highlighted in blue:
Which means the positioning continues to be being setup and it is advisable to wait a couple of minute. Maintain refreshing the web page till the blue shaded field within the “GitHub Pages” part adjustments once more to be highlighted inexperienced like this:
Clicking the revealed web site hyperlink ought to take you to your new undertaking web site! My web site will be discovered at: https://codynicholson.github.io/Make_Your_Data_Models_Into_Websites_Article/
You’ll be able to setup a web site for every of your GitHub repositories identical to this one by placing an index.html file within the root of your repository and enabling GitHub pages like this.
It’s superb the GitHub presents these free web sites for every undertaking you create — but it surely does include some limitations. For every undertaking, you can’t have extra views in addition to your index.html file. So if you happen to add page2.html and attempt to reference it out of your index.html you received’t have the ability to get to page2.
One other frequent mistake or constraint of this undertaking web site is that your fundamental HTML file should be named “index.html” and it should be on the root of your repository — that means it can’t referenced from inside one other folder in your repository.
Lastly, attempt to preface each code cell in your web site with a title and/or description markdown cell. It’s so good to have the ability to create undertaking web sites simply and share it with the world — however your content material must be interpretable by any of your websites guests. Even those who don’t know Python. So at all times attempt to summarize what you’re doing properly for the perfect person expertise.