portfolios_lea-jean/themes/academia-hugo/exampleSite/content/post/jupyter/index.md

120 lines
3.3 KiB
Markdown
Raw Normal View History

2022-02-02 16:09:48 +01:00
---
title: Display Jupyter Notebooks with academia
subtitle: Learn how to blog in academia using Jupyter notebooks
summary: Learn how to blog in academia using Jupyter notebooks
authors:
- admin
tags: []
categories: []
date: "2019-02-05T00:00:00Z"
featured: false
draft: false
# Featured image
# To use, add an image named `featured.jpg/png` to your page's folder.
# Focal point options: Smart, Center, TopLeft, Top, TopRight, Left, Right, BottomLeft, Bottom, BottomRight
image:
caption: 'Image credit: [**Unsplash**](https://unsplash.com/photos/CpkOjOcXdUY)'
focal_point: ""
preview_only: false
# Projects (optional).
# Associate this post with one or more of your projects.
# Simply enter your project's folder or file name without extension.
# E.g. `projects = ["internal-project"]` references `content/project/deep-learning/index.md`.
# Otherwise, set `projects = []`.
projects: []
# Set captions for image gallery.
gallery_item:
- album: gallery
caption: Default
image: theme-default.png
- album: gallery
caption: Ocean
image: theme-ocean.png
- album: gallery
caption: Forest
image: theme-forest.png
- album: gallery
caption: Dark
image: theme-dark.png
- album: gallery
caption: Apogee
image: theme-apogee.png
- album: gallery
caption: 1950s
image: theme-1950s.png
- album: gallery
caption: Coffee theme with Playfair font
image: theme-coffee-playfair.png
- album: gallery
caption: Strawberry
image: theme-strawberry.png
---
```python
from IPython.core.display import Image
Image('https://www.python.org/static/community_logos/python-logo-master-v3-TM-flattened.png')
```
![png](./academia_0_0.png)
```python
print("Welcome to academia!")
```
Welcome to academia!
## Install Python and Jupyter
[Install Anaconda](https://www.anaconda.com/distribution/#download-section) which includes Python 3 and Jupyter notebook.
Otherwise, for advanced users, install Jupyter notebook with `pip3 install jupyter`.
## Create a new blog post [as usual](https://sourcethemes.com/academic/docs/managing-content/#create-a-blog-post)
Run the following commands in your Terminal, substituting `<MY_WEBSITE_FOLDER>` and `my-post` with the file path to your academia website folder and a name for your blog post (without spaces), respectively:
```bash
cd <MY_WEBSITE_FOLDER>
hugo new --kind post post/my-post
cd <MY_WEBSITE_FOLDER>/content/post/my-post/
```
## Create or upload a Jupyter notebook
Run the following command to start Jupyter within your new blog post folder. Then create a new Jupyter notebook (*New > Python Notebook*) or upload a notebook.
```bash
jupyter notebook
```
## Convert notebook to Markdown
```bash
jupyter nbconvert Untitled.ipynb --to markdown --NbConvertApp.output_files_dir=.
# Copy the contents of Untitled.md and append it to index.md:
cat Untitled.md | tee -a index.md
# Remove the temporary file:
rm Untitled.md
```
## Edit your post metadata
Open `index.md` in your text editor and edit the title etc. in the [front matter](https://sourcethemes.com/academic/docs/front-matter/) according to your preference.
To set a [featured image](https://sourcethemes.com/academic/docs/managing-content/#featured-image), place an image named `featured` into your post's folder.
For other tips, such as using math, see the guide on [writing content with academia](https://sourcethemes.com/academic/docs/writing-markdown-latex/).