mirror of
https://github.com/encode/django-rest-framework.git
synced 2024-11-24 02:24:03 +03:00
108 lines
3.8 KiB
Python
Executable File
108 lines
3.8 KiB
Python
Executable File
#!/usr/bin/env python
|
|
|
|
import markdown
|
|
import os
|
|
import re
|
|
import shutil
|
|
import sys
|
|
|
|
root_dir = os.path.abspath(os.path.dirname(__file__))
|
|
docs_dir = os.path.join(root_dir, 'docs')
|
|
html_dir = os.path.join(root_dir, 'html')
|
|
|
|
local = not '--deploy' in sys.argv
|
|
preview = '-p' in sys.argv
|
|
|
|
if local:
|
|
base_url = 'file://%s/' % os.path.normpath(os.path.join(os.getcwd(), html_dir))
|
|
suffix = '.html'
|
|
index = 'index.html'
|
|
else:
|
|
base_url = 'http://django-rest-framework.org'
|
|
suffix = '.html'
|
|
index = ''
|
|
|
|
|
|
main_header = '<li class="main"><a href="#{{ anchor }}">{{ title }}</a></li>'
|
|
sub_header = '<li><a href="#{{ anchor }}">{{ title }}</a></li>'
|
|
code_label = r'<a class="github" href="https://github.com/tomchristie/django-rest-framework/tree/master/rest_framework/\1"><span class="label label-info">\1</span></a>'
|
|
|
|
page = open(os.path.join(docs_dir, 'template.html'), 'r').read()
|
|
|
|
# Copy static files
|
|
# for static in ['css', 'js', 'img']:
|
|
# source = os.path.join(docs_dir, 'static', static)
|
|
# target = os.path.join(html_dir, static)
|
|
# if os.path.exists(target):
|
|
# shutil.rmtree(target)
|
|
# shutil.copytree(source, target)
|
|
|
|
for (dirpath, dirnames, filenames) in os.walk(docs_dir):
|
|
relative_dir = dirpath.replace(docs_dir, '').lstrip(os.path.sep)
|
|
build_dir = os.path.join(html_dir, relative_dir)
|
|
|
|
if not os.path.exists(build_dir):
|
|
os.makedirs(build_dir)
|
|
|
|
for filename in filenames:
|
|
path = os.path.join(dirpath, filename)
|
|
|
|
if not filename.endswith('.md'):
|
|
if relative_dir:
|
|
output_path = os.path.join(build_dir, filename)
|
|
shutil.copy(path, output_path)
|
|
continue
|
|
|
|
output_path = os.path.join(build_dir, filename[:-3] + '.html')
|
|
|
|
toc = ''
|
|
text = open(path, 'r').read().decode('utf-8')
|
|
main_title = None
|
|
description = 'Django, API, REST'
|
|
for line in text.splitlines():
|
|
if line.startswith('# '):
|
|
title = line[2:].strip()
|
|
template = main_header
|
|
description = description + ', ' + title
|
|
elif line.startswith('## '):
|
|
title = line[3:].strip()
|
|
template = sub_header
|
|
else:
|
|
continue
|
|
|
|
if not main_title:
|
|
main_title = title
|
|
anchor = title.lower().replace(' ', '-').replace(':-', '-').replace("'", '').replace('?', '').replace('.', '')
|
|
template = template.replace('{{ title }}', title)
|
|
template = template.replace('{{ anchor }}', anchor)
|
|
toc += template + '\n'
|
|
|
|
if filename == 'index.md':
|
|
main_title = 'Django REST framework - APIs made easy'
|
|
else:
|
|
main_title = 'Django REST framework - ' + main_title
|
|
|
|
content = markdown.markdown(text, ['headerid'])
|
|
|
|
output = page.replace('{{ content }}', content).replace('{{ toc }}', toc).replace('{{ base_url }}', base_url).replace('{{ suffix }}', suffix).replace('{{ index }}', index)
|
|
output = output.replace('{{ title }}', main_title)
|
|
output = output.replace('{{ description }}', description)
|
|
output = output.replace('{{ page_id }}', filename[:-3])
|
|
output = re.sub(r'a href="([^"]*)\.md"', r'a href="\1%s"' % suffix, output)
|
|
output = re.sub(r'<pre><code>:::bash', r'<pre class="prettyprint lang-bsh">', output)
|
|
output = re.sub(r'<pre>', r'<pre class="prettyprint lang-py">', output)
|
|
output = re.sub(r'<a class="github" href="([^"]*)"></a>', code_label, output)
|
|
open(output_path, 'w').write(output.encode('utf-8'))
|
|
|
|
if preview:
|
|
import subprocess
|
|
|
|
url = 'html/index.html'
|
|
|
|
try:
|
|
subprocess.Popen(["open", url]) # Mac
|
|
except OSError:
|
|
subprocess.Popen(["xdg-open", url]) # Linux
|
|
except:
|
|
os.startfile(url) # Windows
|