Skip to content

How to submit to the Showcase:

Info

To add your instance of GeoBlacklight to the Showcase, you will need the following:

  • title
  • thumbnail image
  • description
  • site link

Option A: Ask a GeoBlacklight community member to edit this site

  1. Create a new issue on GitHub here.
  2. Include the title, description and GeoBlacklight site link in the body of the issue
  3. Upload an image to the issue that shows your homepage
  4. Include the label "showcase"
  5. Someone from the community will pick up the issue and add your instance to this site. It may be helpful to make a comment in Slack to make sure we are aware of the request.

Option B: Update files and create a pull request in GitHub ("DIY" option)

  1. Follow the instructions in the GitHub readme file on how to install mkdocs and clone this site to your desktop: https://github.com/geoblacklight/geoblacklight.github.io.
  2. Make a new branch.
  3. Navigate to this folder: docs/showcase/.
  4. Add your image to the showcase folder (jpg or png).
  5. Open docs/showcase/index.md.

  6. Create a new entry by copying and pasting the following template into the index.md file:

    - title: 
  image: 
  content: 
  url:

  7. Enter your information and image filename.

  8. Alphabetize your entry by title so that it appears on the Showcase page in a predicatable location.
  9. Preview your changes locally with the mkdocs serve command (see the readme for instructions).
  10. Commit your changes to the GitHub branch.
  11. Publish your branch.
  12. Open a pull request to the Main branch.
  13. Someone from the community will review and/or merge your submission.