Skip to content

Commit

Permalink
Update: changing the docstring format to Google
Browse files Browse the repository at this point in the history
Add: mkdocs.yml
Add: CI for building the page
  • Loading branch information
Suke0811 committed Jul 31, 2023
1 parent 852a2e1 commit a32eaf0
Show file tree
Hide file tree
Showing 5 changed files with 281 additions and 68 deletions.
25 changes: 25 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
name: ci
on:
push:
branches:
- master
- main
permissions:
contents: write
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: actions/setup-python@v4
with:
python-version: 3.x
- run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
- uses: actions/cache@v3
with:
key: mkdocs-material-${{ env.cache_id }}
path: .cache
restore-keys: |
mkdocs-material-
- run: pip install mkdocs-material
- run: mkdocs gh-deploy --force
20 changes: 20 additions & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# Welcome to MkDocs

For full documentation visit [mkdocs.org](https://www.mkdocs.org).

## Commands

* `mkdocs new [dir-name]` - Create a new project.
* `mkdocs serve` - Start the live-reloading docs server.
* `mkdocs build` - Build the documentation site.
* `mkdocs -h` - Print help message and exit.

## Project layout

mkdocs.yml # The configuration file.
docs/
index.md # The documentation homepage.
... # Other markdown pages, images and other files.


::: t265.Tracking.Tracking
4 changes: 4 additions & 0 deletions docs_requirements.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
mkdocs
mkdocs-material
mkdocs-git-revision-date-localized-plugin
mkdocstrings[python]
124 changes: 124 additions & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,124 @@
site_name: T265 Tracking Camera
theme:
# favicon: images/lemur_logo.svg
# logo: images/lemur_logo.svg
icon:
repo: fontawesome/brands/github
name: material
features:
- navigation.tabs
- navigation.sections
- toc.integrate
- navigation.top
- navigation.footer
- navigation.instant
- navigation.expand
- search.suggest
- search.highlight
- content.tabs.link
- content.code.annotation
- content.code.copy
- header.autohide
- announce.dismiss
language: en
palette:
- scheme: default
toggle:
icon: material/toggle-switch-off-outline
name: Switch to dark mode
primary: teal
accent: blue
- scheme: slate
toggle:
icon: material/toggle-switch
name: Switch to light mode
primary: teal
accent: lime

markdown_extensions:
- attr_list
- md_in_html
- tables
- footnotes
- pymdownx.emoji:
emoji_index: !!python/name:materialx.emoji.twemoji
emoji_generator: !!python/name:materialx.emoji.to_svg
options:
custom_icons:
- overrides/.icons
- pymdownx.highlight:
anchor_linenums: true
line_spans: __span
pygments_lang_class: true
- pymdownx.inlinehilite
- pymdownx.snippets:
url_request_headers: ''
url_download: true
- pymdownx.superfences
- pymdownx.tabbed:
alternate_style: true
- toc:
permalink: true
- pymdownx.superfences:
custom_fences:
- name: mermaid
class: mermaid
format: !!python/name:pymdownx.superfences.fence_code_format
- pymdownx.arithmatex:
generic: true
- pymdownx.critic
- pymdownx.caret
- pymdownx.keys
- pymdownx.mark
- pymdownx.tilde
- admonition
- pymdownx.details
- pymdownx.tasklist:
clickable_checkbox: true
custom_checkbox: true
- pymdownx.tabbed


extra:
social:
- icon: fontawesome/brands/github
link: https://github.com/Suke0811/Localization_T265

generator: true

copyright: Copyright © 2022 - 2023 UCLA Lemur
repo_url: https://github.com/Suke0811/Localization_T265
repo_name: Suke0811/Localization_T265

plugins:
- search
- git-revision-date-localized
- mkdocstrings:
default_handler: python
handlers:
python:
options:
show_source: false
members_order: source

# - git-authors
# - table-reader
# - mkdocs-jupyter
# - glightbox
# - macros:
# include_yaml:
# - docs/macros/glob_macros.yaml
# module_name: docs/macros/codes

extra_javascript:
# - https://unpkg.com/[email protected]/dist/tablesort.min.js
# - javascripts/tablesort.js
- javascripts/mathjax.js
- https://polyfill.io/v3/polyfill.min.js?features=es6
- https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js


nav:
- Home:
- index.md
- about_us.md
Loading

0 comments on commit a32eaf0

Please sign in to comment.