diff --git a/_config.yml b/_config.yml index 3686ae24b..d10c03d68 100644 --- a/_config.yml +++ b/_config.yml @@ -21,9 +21,12 @@ bibtex_bibfiles: # Information about where the book exists on the web repository: - url: https://projectpythia.github.io/pythia-foundations # Online location of your book + url: https://github.com/ProjectPythia/pythia-foundations # Online location of your book #path_to_book: docs # Optional path to your book, relative to the repository root branch: main # Which branch of the repository should be used when creating links (optional) +# Configure your Binder links, such as the URL of the BinderHub. +launch_buttons: + binderhub_url : https://mybinder.org # Add GitHub buttons to your book # See https://jupyterbook.org/customize/config.html#add-a-link-to-your-repository diff --git a/_toc.yml b/_toc.yml index dfd0ba77f..aa4115ab2 100644 --- a/_toc.yml +++ b/_toc.yml @@ -12,6 +12,8 @@ chapters: - file: foundations/overview - file: foundations/basic-python + sections: + - file: foundations/Hello - file: foundations/jupyter - file: foundations/markdown - file: foundations/conda diff --git a/foundations/Hello.ipynb b/foundations/Hello.ipynb new file mode 100644 index 000000000..d0844244d --- /dev/null +++ b/foundations/Hello.ipynb @@ -0,0 +1,77 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "id": "interracial-cheat", + "metadata": {}, + "source": [ + "# Fun with Python\n", + "\n", + "A very minimal example for the Pythia Foundations collection." + ] + }, + { + "cell_type": "markdown", + "id": "documented-idaho", + "metadata": {}, + "source": [ + "A Python program can be a single line:" + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "id": "after-jenny", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Hello interweb\n" + ] + } + ], + "source": [ + "print('Hello interweb')" + ] + }, + { + "cell_type": "markdown", + "id": "accompanied-crash", + "metadata": {}, + "source": [ + "Try it out in Binder and run it yourself!" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "id": "future-transcription", + "metadata": {}, + "outputs": [], + "source": [] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.8.6" + } + }, + "nbformat": 4, + "nbformat_minor": 5 +} diff --git a/foundations/basic-python.md b/foundations/basic-python.md index fe4647cfe..d9809057d 100644 --- a/foundations/basic-python.md +++ b/foundations/basic-python.md @@ -3,3 +3,11 @@ ```{note} This content is under construction! ``` + +This section will contain tutorials on some basics of Python syntax. We will not cover a comprehensive introduction to programming concepts, but will aim this material at people who have done at least some coding before but are new to Python. + +We can use [Jupyter](jupyter) notebooks for much of the content, which will be rendered here as static pages but also be Binderized for interactive learning. + +Here's a minimal example: + +- [Fun with Python](Hello)