def generate_api_doc(env_root, src_dir, web_docs): if src_dir.endswith(".md"): dest_dir, filename = get_api_doc_dest_path(env_root, src_dir) if not os.path.exists(dest_dir): os.makedirs(dest_dir) # parse and JSONify the API docs docs_md = open(src_dir, 'r').read() docs_parsed = list(apiparser.parse_hunks(docs_md)) docs_json = json.dumps(docs_parsed) dest_path_json = os.path.join(dest_dir, filename) + ".json" replace_file(dest_path_json, docs_json) # write the HTML div files docs_div = apirenderer.json_to_div(docs_parsed, src_dir) dest_path_div = os.path.join(dest_dir, filename) + ".div" replace_file(dest_path_div, docs_div) # write the standalone HTML files docs_html = web_docs.create_module_page(src_dir) dest_path_html = os.path.join(dest_dir, filename) + ".html" replace_file(dest_path_html, docs_html) return dest_path_html
def generate_api_doc(env_root, src_dir, web_docs): if src_dir.endswith(".md"): dest_dir, filename = get_api_doc_dest_path(env_root, src_dir) if not os.path.exists(dest_dir): os.makedirs(dest_dir) # parse and JSONify the API docs docs_md = open(src_dir, 'r').read() docs_parsed = list(apiparser.parse_hunks(docs_md)) docs_json = json.dumps(docs_parsed) dest_path_json = os.path.join(dest_dir, filename) + ".json" replace_file(dest_path_json, docs_json) # write the HTML div files docs_div = apirenderer.json_to_div(docs_parsed, src_dir) dest_path_div = os.path.join(dest_dir, filename) + ".div" replace_file(dest_path_div, docs_div) # write the standalone HTML files docs_html = web_docs.create_module_page(src_dir) dest_path_html = os.path.join(dest_dir, filename) + ".html" replace_file(dest_path_html, docs_html) return dest_path_html
def parse_text(self, text): return list(parse_hunks(text))
def parse_text(self, text): return list(parse_hunks(text))