Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Feature/gh pages #100

Closed
wants to merge 4 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
57 changes: 57 additions & 0 deletions .github/workflows/build-sphinx.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
name: build-sphinx-to-gh-pages

env:
GITHUB_ACTOR: Springcomp
GITHUB_REPOSITORY: jmespath-unofficial/jmespath.site

on:
push:
branches:
- master

jobs:

build-sphinx-job:
runs-on: ubuntu-latest
container: debian:buster-slim

steps:
- name: 📚 checkout
uses: actions/checkout@v2

- name: install prerequisites
run: |
set -x
apt-get update
apt-get install -y \
git \
make \
python3-sphinx
shell: bash

- name: prepare GitHub pages
run: |
git init
git config --local user.name "${GITHUB_ACTOR}"
git config --local user.email "${GITHUB_ACTOR}@users.noreply.github.com"
git remote add deploy "https://${GITHUB_ACTOR}:${GITHUB_PERSONAL_ACCESS_TOKEN}@github.com/${GITHUB_REPOSITORY}.git"
git checkout -b gh-pages
touch docs/.nojekyll
shell: bash
env:
GITHUB_PERSONAL_ACCESS_TOKEN: ${{ secrets.PERSONAL_ACCESS_TOKEN }}

- name: build Sphinx
run: |
make clean
make html
shell: bash

- name: publish GitHub pages
run: |
cp -r documentation/_build/html/* docs/
git add -f --all docs/*
git add -f docs/.nojekyll
git commit -am "[gh-pages] Publishing changes to GitHub pages"
git push deploy gh-pages --force
shell: bash
3 changes: 2 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
@@ -1,2 +1,3 @@
docs/_build/*
documentation/_build/
docs/
*.pyc
12 changes: 4 additions & 8 deletions Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -2,20 +2,16 @@ help:
@echo 'Makefile for a pelican Web site '
@echo ' '
@echo 'Usage: '
@echo ' make publish upload to s3 bucket '
@echo ' make clean '
@echo ' make html '


publish:
$(MAKE) -C docs/ publish

clean:
$(MAKE) -C docs/ clean
$(MAKE) -C documentation/ clean

html:
$(MAKE) -C docs/ html
$(MAKE) -C documentation/ html

doclint:
find . -type f -name "*.rst" | xargs doc8


.PHONY: help publish
File renamed without changes.
File renamed without changes.
File renamed without changes
Original file line number Diff line number Diff line change
Expand Up @@ -45,20 +45,20 @@ <h2>Try it Out!</h2>
<p>The expression is evaluated against the JSON data and the result is
shown in the result pane.</p>
<p>To learn more about JMESPath, check out the
<a href="{{ pathto('tutorial') }}">JMESPath Tutorial</a> and
<a href="{{ pathto('examples') }}">JMESPath Examples</a>.
<a href="{{ pathto('tutorial.html', 1) }}">JMESPath Tutorial</a> and
<a href="{{ pathto('examples.html', 1) }}">JMESPath Examples</a>.
<p>Have questions? Come <a href="https://gitter.im/jmespath/chat">chat with us</a>.</p>
<p></p>
<p></p>
<a href="{{ pathto('tutorial') }}" class="btn btn-info btn-lg">JMESPath Tutorial</a>
<a href="{{ pathto('tutorial.html', 1) }}" class="btn btn-info btn-lg">JMESPath Tutorial</a>
</div>
</div>
<div class="row">
<div class="col-md-4">
<h3 class="section-distinct">A Complete Specification</h3>
<p>
The JMESPath language is described in an
<a href="{{ pathto('specification') }}">ABNF grammar</a> with a complete
<a href="{{ pathto('specification.html', 1) }}">ABNF grammar</a> with a complete
specification. This ensures that the language syntax is precisely defined.
</p>
</div>
Expand All @@ -67,14 +67,14 @@ <h3 class="section-distinct">A compliance test suite</h3>
<p>
JMESPath has a full suite of data driven testcases. This ensures
parity for multiple libraries, and makes it easy for developers to
<a href="{{ pathto('compliance') }}">implement JMESPath</a> in their
<a href="{{ pathto('compliance.html', 1) }}">implement JMESPath</a> in their
language of choice.
</p>
</div>
<div class="col-md-4">
<h3 class="section-distinct">Libraries in Multiple Languages</h3>
<p>
Each <a href="{{ pathto('libraries') }}">JMESPath library</a>
Each <a href="{{ pathto('libraries.html', 1) }}">JMESPath library</a>
passes a complete suite of compliance tests to ensure they work as intended.
There are libraries in multiple languages including python, php,
javascript and lua.
Expand Down
File renamed without changes.
File renamed without changes.
Empty file added documentation/_themes/README
Empty file.
Original file line number Diff line number Diff line change
Expand Up @@ -111,11 +111,11 @@
</div>
<div class="collapse navbar-collapse" id="toggle-main-nav">
<ul class="nav navbar-nav">
<li><a href="/">Home</a></li>
<li><a href="/tutorial.html">Tutorial</a></li>
<li><a href="/examples.html">Examples</a></li>
<li><a href="/specification.html">Specification</a></li>
<li><a href="/libraries.html">Libraries</a></li>
<li><a href="{{ pathto('index.html', 1) }}">Home</a></li>
<li><a href="{{ pathto('tutorial.html', 1) }}">Tutorial</a></li>
<li><a href="{{ pathto('examples.html', 1) }}">Examples</a></li>
<li><a href="{{ pathto('specification.html', 1) }}">Specification</a></li>
<li><a href="{{ pathto('libraries.html', 1) }}">Libraries</a></li>
<li><a href="https://github.com/jmespath">Github</a></li>
</ul>
</div>
Expand Down
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.