swh:1:snp:5d08e1a590957faccdc77737b5e8f49534d091bc
Tip revision: 10f3e966d031c3df7734c8458da56a2389c275ef authored by pyxieloustar on 17 November 2021, 16:24:26 UTC
move corrections into functions; only correct in-range values
move corrections into functions; only correct in-range values
Tip revision: 10f3e96
make_index.py
# -*- mode: python; coding: utf-8 -*-
"""
Format the readme.md file into the sphinx index.rst file.
"""
import os
import inspect
import pypandoc
from astropy.time import Time
def write_index_rst(readme_file=None, write_file=None):
t = Time.now()
t.format = "iso"
t.out_subfmt = "date"
out = (
".. pyuvdata documentation top-level file, created by\n"
" make_index.py on {date}\n\n"
).format(date=t.iso)
if readme_file is None:
main_path = os.path.dirname(
os.path.dirname(os.path.abspath(inspect.stack()[0][1]))
)
readme_file = os.path.join(main_path, "README.md")
readme_text = pypandoc.convert_file(readme_file, "rst")
# convert relative links in readme to explicit links
readme_text = readme_text.replace(
"<docs/",
"<https://github.com/RadioAstronomySoftwareGroup/pyuvdata/tree/main/docs/",
)
readme_text = readme_text.replace(
"<.github/",
"<https://github.com/RadioAstronomySoftwareGroup/pyuvdata/tree/main/.github/",
)
out += readme_text
out += (
"\n\nFurther Documentation\n====================================\n"
".. toctree::\n"
" :maxdepth: 1\n\n"
" tutorial\n"
" uvdata_parameters\n"
" uvdata\n"
" uvcal_parameters\n"
" uvcal\n"
" uvbeam_parameters\n"
" uvbeam\n"
" uvflag_parameters\n"
" uvflag\n"
" cst_settings_yaml\n"
" utility_functions\n"
" known_telescopes\n"
" developer_docs\n"
)
out.replace(u"\u2018", "'").replace(u"\u2019", "'").replace(u"\xa0", " ")
if write_file is None:
write_path = os.path.dirname(os.path.abspath(inspect.stack()[0][1]))
write_file = os.path.join(write_path, "index.rst")
F = open(write_file, "w")
F.write(out)
print("wrote " + write_file)