0 to portfolio website

isabel zimmerman

Me!

  • Software engineer @ Posit
  • FL Poly grad in ’21 and again in ’23 👾
  • Working on Positron IDE
  • Building and maintaining Python packages like vetiver and pins

You!

  • What’s your degree program?
  • What year are you?
  • Who are you most excited to see at the career fair?

End goal

What is GitHub?

  • version control: track changes and revert to previous versions easily.
  • collaboration: work with others without overwriting code.
  • portfolio building: show coding skills to employers.
  • open-source world: contribute to real-world projects and communities.
  • project management: organize tasks and track progress.

What is Quarto?

  • literate programming: Create reports, blogs, and presentations with code and text.
  • many formats: Export to PDF, HTML, Word, Powerpoint, and more.

Help me help you

  • 🟩/🟦: I’m finished with my task
  • 🟥: I’m stuck
  • There will be time at the end to help you get unstuck!

What you’ll need

05:00

Get git on your computer

git config --global user.name "YOUR NAME"
git config --global user.email "YOUR_EMAIL"
05:00

Create repository for your blog

Create a new repository with the name: your-username.github.io

02:00

Clone repository

Clone repository

# use your copied repo name!
git clone https://github.com/isabelizimm/isabelizimm.github.io.git
  • Run this command in the terminal in the directory you would like your website.
  • For me, I use something like ~/code/isabelizimm.github.io
02:00

Create blog!

  • Use command+shift+p to open the Command Palette
  • If you don’t have a command key, use ctrl instead
  • Quarto: Create Project -> Blog
02:00

Change _quarto.yml file

01:00

Update about.qmd

02:00

Check out your beautiful blog!

  • Click Preview button in top right corner OR run quarto preview in terminal

Publish blog, part 1

  • In the terminal, run quarto publish gh-pages
01:00

Publish blog, part 2

  • Go to your GitHub repo -> Settings -> Pages
  • Choose Deploy from branch and set the branch to gh-pages
02:00

Source code on git

git add .
git commit -m "explain what you did"
git push

YOU DID IT!!!!

Bonus content: updating website

What is a Quarto markdown file?

  • Text
  • Code (either static or run on render)
  • Show examples
```python
1+1
```

Where can I edit the look of a website?

  • Primarily in the _quarto.yml file
  • Check out docs to see themes or other customization
  • Let’s do a mini walkthrough of the site

Feel free to edit away!

Ask me about

  • the data scientist -> software engineer pipeline
  • working in the open
  • anything else!