Viewing and Sharing Visual Essays - JSTOR-Labs/juncture GitHub Wiki

Default URLs

All Visual Essays can be viewed from the Juncture website. For Visual Essays viewed from the Juncture site the URL is: https://juncture-digital.org/<Github-account>/<Github-repository>/essay-path, where:

• Github-account is your Github account name.
• Github-repository is the name of the Github repository (in your Github account) that contains the Visual Essay file.
• essay-path is the (optional) path to the Visual Essay file (or folder). When referencing the default essay in a repository the path argument is not used. The default essay for a repository is contained in the README.md file located at the repository root.

Examples:

• https://juncture-digital.org/jstor-labs/juncture-examples - Displays the Visual Essay located in the README.md file located at the root of the juncture-examples repository in the jstor-labs Github account.
• https://juncture-digital.org/jstor-labs/juncture-examples/girl-with-a-pearl-earring - Displays a non-default Visual Essay from the juncture-examples repository in the jstor-labs Github account.

Personal Juncture Site URLs

In this section we see how URLs are formed for Visual Essays in a Juncture site. A Juncture site is a Github repository that has been configured as a web hosting repository using Github Pages and optionally configured with a custom domain. Note that the juncture-digital.org URLs described above will still work when the repository is configured as a Juncture site.

Github Pages

When a Juncture site is created in your personal Github account the Github Pages repository feature is enabled. Github Pages turns a regular Github repository into a web site hosting platform. The URL for a Visual Essay hosted on a personal Juncture site (using Github Pages) is: https://<Github-account>.github.io/<Github-repository>/essay-path

Examples:

• https://jstor-labs.github.io/juncture-examples - Displays the Visual Essay located in the README.md file located at the root of the juncture-examples repository in the jstor-labs Github account.
• https://jstor-labs.github.io/juncture-examples/girl-with-a-pearl-earring - Displays a non-default Visual Essay from the juncture-examples repository in the jstor-labs Github account.

Custom Domains

A custom domain can be used instead of the github.io domain when using Juncture to host a website from your Github Pages powered repository. The URL for a Visual Essay hosted on a personal Juncture site (using a custom domain) is: https://<your-custom-domain>/essay-path

Examples:

In these examples we use the custom domain lab.plant-humanities.org which has been applied to the Github Pages enabled JSTOR-Labs/plant-humanities repository.

• https://lab.plant-humanities.org/sunflower - Displays the Visual Essay located in the README.md file located at the root of the plant-humanities repository in the jstor-labs Github account.
• https://lab.plant-humanities.org/sunflower - Displays a non-default Visual Essay from the plant-humanities repository in the jstor-labs Github account.