Skip to content

Commit 3906035

Browse files
committed
Added docs
1 parent 23a101f commit 3906035

File tree

3 files changed

+113
-7
lines changed

3 files changed

+113
-7
lines changed

.github/workflows/docs.yml

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
name: Docs
2+
3+
on:
4+
push:
5+
branches: [ main ]
6+
7+
permissions:
8+
contents: read
9+
pages: write
10+
id-token: write
11+
12+
concurrency:
13+
group: "pages"
14+
cancel-in-progress: true
15+
16+
jobs:
17+
build:
18+
runs-on: ubuntu-latest
19+
steps:
20+
- uses: actions/checkout@v4
21+
22+
- name: Setup Python
23+
uses: actions/setup-python@v5
24+
with:
25+
python-version: "3.11"
26+
cache: pip
27+
28+
- name: Install docs deps
29+
run: |
30+
python -m pip install -U pip
31+
pip install -e . --no-deps
32+
pip install mkdocs mkdocs-material mkdocstrings[python] mkdocs-jupyter
33+
34+
- name: Build docs
35+
run: mkdocs build --strict
36+
37+
- name: Upload artifact
38+
uses: actions/upload-pages-artifact@v3
39+
with:
40+
path: site
41+
42+
deploy:
43+
needs: build
44+
runs-on: ubuntu-latest
45+
environment:
46+
name: github-pages
47+
url: ${{ steps.deployment.outputs.page_url }}
48+
steps:
49+
- name: Deploy to GitHub Pages
50+
id: deployment
51+
uses: actions/deploy-pages@v4

MANIFEST,in

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
include README.md
2+
include LICENSE
3+
recursive-include financepy/data *.npz

mkdocs.yml

Lines changed: 59 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,63 @@
1-
site_name: financepy
1+
site_name: FinancePy
2+
site_description: "A Finance Securities Valuation Library"
3+
site_author: "Dominic O'Kane"
4+
repo_url: https://github.com/domokane/FinancePy
5+
repo_name: FinancePy
6+
edit_uri: ""
27

38
theme:
4-
name: readthedocs
9+
name: material
10+
logo: images/logo.png # optional if you have a logo
11+
favicon: images/favicon.png
12+
palette:
13+
- scheme: default
14+
primary: blue
15+
accent: cyan
16+
- scheme: slate
17+
primary: blue
18+
accent: cyan
19+
toggle:
20+
icon: material/weather-night
21+
name: Switch to dark mode
22+
23+
nav:
24+
- Home: index.md
25+
- Quick Start: quickstart.md
26+
- Tutorials:
27+
- Bonds: tutorials/bonds.md
28+
- Options: tutorials/options.md
29+
- Credit: tutorials/credit.md
30+
- API Reference:
31+
- Products: api/products.md
32+
- Models: api/models.md
33+
- Markets: api/markets.md
34+
- Utils: api/utils.md
35+
- Examples: examples.md
36+
- About: about.md
37+
38+
markdown_extensions:
39+
- admonition
40+
- codehilite
41+
- footnotes
42+
- meta
43+
- toc:
44+
permalink: true
545

646
plugins:
7-
- search
8-
- mkdocstrings
9-
- gen-files:
10-
scripts:
11-
- docs/generate.py
47+
- search
48+
- mkdocstrings:
49+
handlers:
50+
python:
51+
options:
52+
show_source: true
53+
heading_level: 2
54+
docstring_style: google
55+
- mkdocs-jupyter:
56+
execute: false # set true if you want notebooks auto-executed
57+
58+
extra:
59+
social:
60+
- icon: fontawesome/brands/github
61+
link: https://github.com/domokane/FinancePy
62+
- icon: fontawesome/brands/python
63+
link: https://pypi.org/project/financepy/

0 commit comments

Comments
 (0)