mkdocs.yml

   1 site_name: Nominatim Manual
   2 theme:
   3   name: material
   4   features:
   5     - navigation.tabs
   6 copyright: Copyright &copy; Nominatim developer community
   7 docs_dir: docs
   8 site_url: https://nominatim.org
   9 repo_url: https://github.com/openstreetmap/Nominatim
  10 nav:
  11     - 'Introduction' : 'index.md'
  12     - 'API Reference':
  13         - 'Overview': 'api/Overview.md'
  14         - 'Search': 'api/Search.md'
  15         - 'Reverse': 'api/Reverse.md'
  16         - 'Address Lookup': 'api/Lookup.md'
  17         - 'Details' : 'api/Details.md'
  18         - 'Status' : 'api/Status.md'
  19         - 'Place Output Formats': 'api/Output.md'
  20         - 'FAQ': 'api/Faq.md'
  21     - 'Administration Guide':
  22         - 'Basic Installation': 'admin/Installation.md'
  23         - 'Import' : 'admin/Import.md'
  24         - 'Update' : 'admin/Update.md'
  25         - 'Deploy (Python frontend)' : 'admin/Deployment-Python.md'
  26         - 'Deploy (PHP frontend)' : 'admin/Deployment-PHP.md'
  27         - 'Nominatim UI'  : 'admin/Setup-Nominatim-UI.md'
  28         - 'Advanced Installations' : 'admin/Advanced-Installations.md'
  29         - 'Maintenance' : 'admin/Maintenance.md'
  30         - 'Migration from older Versions' : 'admin/Migration.md'
  31         - 'Troubleshooting' : 'admin/Faq.md'
  32         - 'Installation on Ubuntu 22' : 'admin/Install-on-Ubuntu-22.md'
  33         - 'Installation on Ubuntu 24' : 'admin/Install-on-Ubuntu-24.md'
  34     - 'Customization Guide':
  35         - 'Overview': 'customize/Overview.md'
  36         - 'Import Styles': 'customize/Import-Styles.md'
  37         - 'Configuration Settings': 'customize/Settings.md'
  38         - 'API Result Formatting': 'customize/Result-Formatting.md'
  39         - 'Per-Country Data': 'customize/Country-Settings.md'
  40         - 'Place Ranking' : 'customize/Ranking.md'
  41         - 'Importance' : 'customize/Importance.md'
  42         - 'Tokenizers' : 'customize/Tokenizers.md'
  43         - 'Special Phrases': 'customize/Special-Phrases.md'
  44         - 'External data: US housenumbers from TIGER': 'customize/Tiger.md'
  45         - 'External data: Postcodes': 'customize/Postcodes.md'
  46         - 'Conversion to SQLite': 'customize/SQLite.md'
  47     - 'Library Guide':
  48         - 'Getting Started': 'library/Getting-Started.md'
  49         - 'Nominatim API class': 'library/NominatimAPI.md'
  50         - 'Configuration': 'library/Configuration.md'
  51         - 'Input Parameter Types': 'library/Input-Parameter-Types.md'
  52         - 'Result Handling': 'library/Result-Handling.md'
  53         - 'Low-level DB Access': 'library/Low-Level-DB-Access.md'
  54     - 'Developers Guide':
  55         - 'Architecture Overview' : 'develop/overview.md'
  56         - 'Database Layout' : 'develop/Database-Layout.md'
  57         - 'Indexing' : 'develop/Indexing.md'
  58         - 'Tokenizers' : 'develop/Tokenizers.md'
  59         - 'Custom modules for ICU tokenizer': 'develop/ICU-Tokenizer-Modules.md'
  60         - 'Setup for Development' : 'develop/Development-Environment.md'
  61         - 'Testing' : 'develop/Testing.md'
  62         - 'External Data Sources': 'develop/data-sources.md'
  63 markdown_extensions:
  64     - codehilite
  65     - admonition
  66     - pymdownx.superfences
  67     - pymdownx.tabbed:
  68         alternate_style: true
  69     - def_list
  70     - toc:
  71         permalink: 
  72 extra_css: [extra.css, styles.css]
  73 exclude_docs: |
  74     mk_install_instructions.py
  75 site_dir: site-html
  76 plugins:
  77     - search
  78     - mkdocstrings:
  79         handlers:
  80           python:
  81             paths: ["src"]
  82             options:
  83               show_source: False
  84               show_bases: False
  85     - gen-files:
  86         scripts:
  87           - docs/mk_install_instructions.py