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()