mirror of
https://github.com/qmk/qmk_firmware.git
synced 2024-12-18 07:33:26 +00:00
db1eacdaac
* Align our subprocess usage with current best practices. * remove unused import * Apply suggestions from code review Co-authored-by: Ryan <fauxpark@gmail.com> * fix the cpp invocation for older python * allow for unprompted installation * make sure qmk new-keyboard works on windows Co-authored-by: Ryan <fauxpark@gmail.com>
40 lines
1.0 KiB
Python
40 lines
1.0 KiB
Python
"""Build QMK documentation locally
|
|
"""
|
|
import shutil
|
|
from pathlib import Path
|
|
from subprocess import DEVNULL
|
|
|
|
from milc import cli
|
|
|
|
DOCS_PATH = Path('docs/')
|
|
BUILD_PATH = Path('.build/docs/')
|
|
|
|
|
|
@cli.subcommand('Build QMK documentation.', hidden=False if cli.config.user.developer else True)
|
|
def generate_docs(cli):
|
|
"""Invoke the docs generation process
|
|
|
|
TODO(unclaimed):
|
|
* [ ] Add a real build step... something static docs
|
|
"""
|
|
|
|
if BUILD_PATH.exists():
|
|
shutil.rmtree(BUILD_PATH)
|
|
|
|
shutil.copytree(DOCS_PATH, BUILD_PATH)
|
|
|
|
# When not verbose we want to hide all output
|
|
args = {
|
|
'capture_output': False if cli.config.general.verbose else True,
|
|
'check': True,
|
|
'stdin': DEVNULL,
|
|
}
|
|
|
|
cli.log.info('Generating internal docs...')
|
|
|
|
# Generate internal docs
|
|
cli.run(['doxygen', 'Doxyfile'], **args)
|
|
cli.run(['moxygen', '-q', '-a', '-g', '-o', BUILD_PATH / 'internals_%s.md', 'doxygen/xml'], **args)
|
|
|
|
cli.log.info('Successfully generated internal docs to %s.', BUILD_PATH)
|