Skip to content
upload-cloud

GitHub Action

Github Pages Directory Listing

v4.0.0 Latest version

Github Pages Directory Listing

upload-cloud

Github Pages Directory Listing

Github Action to generate directory listing index for Github Pages

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Github Pages Directory Listing

uses: jayanta525/[email protected]

Learn more about this action in jayanta525/github-pages-directory-listing

Choose a version

Github Pages Directory Listing

main license Paypal Donate

Generate Directory Listings for Github Pages using Github Actions.

Demo

Read about pages deployment action

action.yml/workflow.yml

Usage

Getting Started

Add a .github/workflows/workflow.yml to the root of your repository.

name: directory-listing
on: [push]

jobs:
  pages-directory-listing:
    runs-on: ubuntu-latest
    name: Directory Listings Index
    steps:
      - name: Checkout Repository
        uses: actions/checkout@v3
        with:
          ref: dummy-data    #checkout different branch

      - name: Generate Directory Listings
        uses: jayanta525/[email protected]
        with:
          FOLDER: data      #directory to generate index

      - name: Upload artifact
        uses: actions/upload-pages-artifact@v1
        with:
          path: 'data'      # upload generated folder
  
  deploy:
    needs: pages-directory-listing
    permissions:
      pages: write      # to deploy to Pages
      id-token: write   # to verify the deployment originates from an appropriate source

    # Deploy to the github-pages environment
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}

    # Specify runner + deployment step
    runs-on: ubuntu-latest
    steps:
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v1

Options

Checkout different branch

      - name: Checkout Repository
        uses: actions/checkout@v3
        with:
          ref: dummy-data    #checkout different branch

Checkout different repository

      - name: Checkout tools repo
        uses: actions/checkout@v3
        with:
          repository: my-org/my-tools     #repo public url
          path: my-tools                  #folder to clone to
          ref: branch-name               #branch to clone

Choosing a folder to generate indexing

      - name: Generate Directory Listings
        uses: jayanta525/[email protected]
        with:
          FOLDER: data    #directory to generate index

Note

This action uses Github's own pages deploy action. No gh-pages branch is required. Under Settings > Pages > Build & Deployment

image

Demo

demo URL: https://jayanta525.github.io/github-pages-directory-listing/

Desktop view

image

Mobile View

image