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