Skip to content

Commit

Permalink
Update to use external links (#63)
Browse files Browse the repository at this point in the history
Co-authored-by: Damian Avila <[email protected]>
  • Loading branch information
choldgraf and damianavila authored Aug 30, 2021
1 parent 2338f17 commit afbe9aa
Show file tree
Hide file tree
Showing 12 changed files with 59 additions and 7 deletions.
25 changes: 25 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,31 @@ Note that pyspelling may find some errors that are simply un-recognized, but cor

For more information, see [the `pyspelling` documentation](https://facelessuser.github.io/pyspelling/).

## Blog post feed

Our blog post feed is at https://2i2c.org/posts/, and contains a feed of posts from 2i2c team members.

This feed contains both **internal** and **external** blog posts.
In general, when team members do work associated with other open source projects, we should write those posts in other spaces and cross-link them from the 2i2c blog.

### Make an internal blog post

The way to make a regular blog post is by following the standard Hugo documentation for internal blog posts. Check out [the WowChemy theme documentation](https://wowchemy.com/docs/content/blog-posts/) for one way to do this.

### Make an external blog post

To make an external blog post, follow these steps:

- Generate a blog post folder and include a markdown file similarly to how you'd generate an internal blog post.
- Add an `external_link` metadata parameter at the top of the file. The value of this parameter will be the external link the post should point to.
- All other metadata can be the same, and will be used to share the post author, published order, etc.

### Featured images in blog posts

Featured images are displayed to the right of each post in our post feed.
By default, you can add a featured image directly to the blog post's folder by adding an image called `featured*`. For example, `featured.jpg`, `featured-image.png`, etc.

If you'd like to re-use another image on the site, you can create a **symbolic link** from the post folder to the image you'd like to re-use. This helps us save space and load time.

## This website's theme

Expand Down
10 changes: 10 additions & 0 deletions assets/jsconfig.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"*": [
"../../../../../../../../tmp/hugo_cache/modules/filecache/modules/pkg/mod/github.com/wowchemy/wowchemy-hugo-modules/wowchemy/[email protected]/assets/*"
]
}
}
}
4 changes: 3 additions & 1 deletion config/_default/config.toml
Original file line number Diff line number Diff line change
Expand Up @@ -109,4 +109,6 @@ ignoreFiles = ["\\.ipynb$", ".ipynb_checkpoints$", "\\.Rmd$", "\\.Rmarkdown$", "
# Academic theme is now called wowchemy and this is how you activate it
[module]
[[module.imports]]
path = "github.com/wowchemy/wowchemy-hugo-modules/wowchemy"
path = "github.com/wowchemy/wowchemy-hugo-modules/wowchemy-cms/v5"
[[module.imports]]
path = "github.com/wowchemy/wowchemy-hugo-modules/wowchemy/v5"
1 change: 1 addition & 0 deletions content/posts/2021/six-month-update/featured-logo.png
1 change: 1 addition & 0 deletions content/posts/czi-core-support/featured-logo.png
1 change: 1 addition & 0 deletions content/posts/hello-world/featured-logo.png
Binary file added content/posts/myst-nikola-part-1/featured.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
12 changes: 12 additions & 0 deletions content/posts/myst-nikola-part-1/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
title: "A deep dive into MyST, Part 1: The MyST-Parser Python API usage in Nikola"
subtitle: ""
summary: ""
authors: ["Damián Avila"]
tags: [jupyter, executablebooks]
categories: []
date: 2021-08-23
featured: false
draft: false
external_link: http://damianavila.github.io/blog/posts/a-deep-dive-into-myst-part-1-the-myst-parser-python-api-usage-in-nikola.html
---
7 changes: 2 additions & 5 deletions go.mod
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
module github.com/wowchemy/starter-academic
module github.com/wowchemy/starter-hugo-academic

go 1.15

require (
github.com/wowchemy/wowchemy-hugo-modules/netlify-cms-academic v0.0.0-20201001144923-e58ee0ffc576 // indirect
github.com/wowchemy/wowchemy-hugo-modules/wowchemy v0.0.0-20201001144923-e58ee0ffc576 // indirect
)
require github.com/wowchemy/wowchemy-hugo-modules/v5 v5.3.0
3 changes: 3 additions & 0 deletions go.sum
Original file line number Diff line number Diff line change
@@ -1,3 +1,6 @@
github.com/wowchemy/wowchemy-hugo-modules/netlify-cms-academic v0.0.0-20201001144923-e58ee0ffc576/go.mod h1:TU3QDPUdBSQnvDP5QVCwjAkBIdVMS/bKFA8jr3eI5AY=
github.com/wowchemy/wowchemy-hugo-modules/v5 v5.3.0/go.mod h1:akNBhhT0UAOXSREplKkLe2wyHeo51qm6f+vqNkQkcmE=
github.com/wowchemy/wowchemy-hugo-modules/wowchemy v0.0.0-20201001144923-e58ee0ffc576 h1:r97j+QgxENainAzooKFwaHePl7UBBtZ4RFh6+Ks2x3U=
github.com/wowchemy/wowchemy-hugo-modules/wowchemy v0.0.0-20201001144923-e58ee0ffc576/go.mod h1:H22qfH9qj3FWwsk7+bAZpmT24yRGNQURah2/IRwjbn8=
github.com/wowchemy/wowchemy-hugo-modules/wowchemy-cms/v5 v5.0.0-20210629192904-559885af86b7/go.mod h1:Sp/AKo+2HAPi/IPHp1MEdKPmee+mzO5+efUBUPLPqPE=
github.com/wowchemy/wowchemy-hugo-modules/wowchemy/v5 v5.0.0-20210629192904-559885af86b7/go.mod h1:2iL9rdrUYyJXX2BeHKfK+QbqZlubCsaR60nQ87NRQTY=
2 changes: 1 addition & 1 deletion netlify.toml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
publish = "public"

[build.environment]
HUGO_VERSION = "0.72.0"
HUGO_VERSION = "0.87.0"
HUGO_ENABLEGITINFO = "true"

[context.production.environment]
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit afbe9aa

Please sign in to comment.