def serve_command(dev_addr, livereload, watch, **kwargs):
"""Run the builtin development server"""
from mkdocs.commands import serve
serve.serve(dev_addr=dev_addr,
livereload=livereload,
watch=watch,
**kwargs)
def run():
"""Create a local server to view markdown files as website."""
mkdocs_yml_exists = os.path.exists(MKDOCS_YML)
if not mkdocs_yml_exists:
with open(MKDOCS_YML, 'w') as out:
out.write("site_name: My Docs\n")
out.write("theme: 'mkdocs'\n")
serve()
def serve_command(dev_addr, livereload, **kwargs):
"""Run the builtin development server"""
logging.getLogger('tornado').setLevel(logging.WARNING)
try:
serve.serve(dev_addr=dev_addr, livereload=livereload, **kwargs)
except (exceptions.ConfigurationError, OSError) as e: # pragma: no cover
# Avoid ugly, unhelpful traceback
raise SystemExit('\n' + str(e))
def serve_command(dev_addr, config_file, strict, theme, livereload):
"""Run the builtin development server"""
logging.getLogger('tornado').setLevel(logging.WARNING)
try:
serve.serve(
config_file=config_file,
dev_addr=dev_addr,
strict=strict,
theme=theme,
livereload=livereload,
)
except (exceptions.ConfigurationError, socket.error) as e:
# Avoid ugly, unhelpful traceback
raise SystemExit('\n' + str(e))
def serve_command(dev_addr, config_file, strict, theme, livereload):
"""Run the builtin development server"""
logging.getLogger('tornado').setLevel(logging.WARNING)
try:
serve.serve(
config_file=config_file,
dev_addr=dev_addr,
strict=strict,
theme=theme,
livereload=livereload,
)
except (exceptions.ConfigurationError, socket.error) as e:
# Avoid ugly, unhelpful traceback
raise SystemExit('\n' + str(e))
def serve_command(dev_addr, config_file, strict, theme, theme_dir, livereload):
"""Run the builtin development server"""
logging.getLogger('tornado').setLevel(logging.WARNING)
# Don't override config value if user did not specify --strict flag
# Conveniently, load_config drops None values
strict = strict or None
try:
serve.serve(config_file=config_file,
dev_addr=dev_addr,
strict=strict,
theme=theme,
theme_dir=theme_dir,
livereload=livereload)
except (exceptions.ConfigurationError, socket.error) as e:
# Avoid ugly, unhelpful traceback
raise SystemExit('\n' + str(e))
def serve_command(dev_addr, config_file, strict, theme, theme_dir, livereload):
"""Run the builtin development server"""
logging.getLogger('tornado').setLevel(logging.WARNING)
# Don't override config value if user did not specify --strict flag
# Conveniently, load_config drops None values
strict = strict or None
try:
serve.serve(
config_file=config_file,
dev_addr=dev_addr,
strict=strict,
theme=theme,
theme_dir=theme_dir,
livereload=livereload
)
except (exceptions.ConfigurationError, socket.error) as e:
# Avoid ugly, unhelpful traceback
raise SystemExit('\n' + str(e))
def generate(config):
DatasetGenerator.CONF = config
pages = [{'Home': 'index.md'}]
for repository in config.repositories():
print(str(repository.name), pages)
subpages = []
pages.append({str(repository.name): subpages})
for datafile in repository.datafiles():
subpages.append({datafile.id: 'a.md'})
break
configuration = {
'site_name': 'Datasets',
'pages': pages,
'theme': 'readthedocs',
'plugins': ['datasets']
}
configstring = yaml.dump(configuration)
cfgfile = io.StringIO(configstring)
# cfg = mkdocs.config.load_config(cfgfile, pages=pages)
# build.build(cfg, dirty=False, live_server=True)
serve.serve(cfgfile)
def serve_command(dev_addr, livereload, **kwargs):
"""Run the builtin development server"""
logging.getLogger('tornado').setLevel(logging.WARNING)
serve.serve(dev_addr=dev_addr, livereload=livereload, **kwargs)
def serve_command(dev_addr, livereload, **kwargs):
"""Run the builtin development server"""
serve.serve(dev_addr=dev_addr, livereload=livereload, **kwargs)
def handle_mkdocs_serve(to_serve, kind, dev_addr):
if to_serve:
serve.serve(config_file=select_config(kind), dev_addr=dev_addr)
def run():
"""Start the development server to preview output."""
with cd(DEFAULT_SITE_DIR):
serve()
