Skip to content

Commit

Permalink
update README for docs on latest usage
Browse files Browse the repository at this point in the history
  • Loading branch information
jayanta525 authored Mar 19, 2023
1 parent be58b89 commit 19ee734
Showing 1 changed file with 54 additions and 11 deletions.
65 changes: 54 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,24 @@
# Github Pages Directory Listing
[![main](https://github.com/jayanta525/github-pages-directory-listing/actions/workflows/main.yml/badge.svg)](https://github.com/jayanta525/github-pages-directory-listing/actions/workflows/main.yml)
[![license](https://img.shields.io/github/license/jayanta525/github-pages-directory-listing)](https://github.com/jayanta525/github-pages-directory-listing/blob/main/LICENSE)
[![Paypal Donate](https://img.shields.io/badge/donate-paypal-00457c.svg?logo=paypal&style=plastic)](https://www.paypal.me/jayanta525)


Generate Directory Listings for Github Pages using Github Actions.

[Demo](https://github.com/jayanta525/github-pages-directory-listing#demo)

[action.yml/workflow.yml](https://github.com/jayanta525/github-pages-directory-listing/blob/main/.github/workflows/main.yml)
## Usage
### Getting Started

Add a `.github/workflows/workflow.yml` to the root of your project where you want directory listings to be enabled.
Add a `.github/workflows/workflow.yml` to the root of your repository.
```
name: directory-listing
on: [push]
jobs:
pages-directory-listing-release:
pages-directory-listing:
runs-on: ubuntu-latest
name: Directory Listings Index
steps:
Expand All @@ -24,16 +28,32 @@ jobs:
ref: dummy-data #checkout different branch
- name: Generate Directory Listings
uses: jayanta525/github-pages-directory-listing@v2.0.0
uses: jayanta525/github-pages-directory-listing@v3.0.0
with:
FOLDER: data #directory to generate index
FOLDER: data #directory to generate index
- name: Deploy to Pages
uses: JamesIves/github-pages-[email protected]
- name: Upload artifact
uses: actions/upload-pages-artifact@v1
with:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
BRANCH: gh-pages
FOLDER: data
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
Expand All @@ -44,15 +64,38 @@ jobs:
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
```
#### Refer here for more options: https://github.com/marketplace/actions/checkout

## Note

This action uses Github's own pages deploy action. So, no gh-pages branch is required.

## Demo
demo URL: https://jayanta525.github.io/openwrt-r4s-kmods/
demo URL: https://jayanta525.github.io/github-pages-directory-listing/


### Desktop view

![image](https://user-images.githubusercontent.com/30702133/226169193-66c27c81-fdc7-499d-88e4-1a1c8571ecce.png)

### Mobile View

![image](https://user-images.githubusercontent.com/30702133/226169252-b74d3a40-7928-4804-bd66-8292a6259531.png)


![image](https://user-images.githubusercontent.com/30702133/184577947-7ebc8b2e-3998-47c7-9289-4069f281f13a.png)

0 comments on commit 19ee734

Please sign in to comment.