parse_pages - improvements to categories, pdf targeting

This commit is contained in:
mDuo13
2015-10-22 13:54:54 -07:00
parent bde7d17f70
commit 718814ee2e
25 changed files with 174 additions and 140 deletions

View File

@@ -44,8 +44,8 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-apis.html">rippled</a></li>
<li><a href="ripple-rest.html">Ripple-REST</a></li>
@@ -61,7 +61,7 @@
</ul>
</li>
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-setup.html">rippled Setup</a></li>
<li><a href="reliable_tx.html">Reliable Transaction Submission</a></li>

View File

@@ -71,8 +71,8 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-apis.html">rippled</a></li>
<li><a href="ripple-rest.html">Ripple-REST</a></li>
@@ -88,7 +88,7 @@
</ul>
</li>
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-setup.html">rippled Setup</a></li>
<li><a href="reliable_tx.html">Reliable Transaction Submission</a></li>

View File

@@ -44,8 +44,8 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-apis.html">rippled</a></li>
<li><a href="ripple-rest.html">Ripple-REST</a></li>
@@ -61,7 +61,7 @@
</ul>
</li>
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-setup.html">rippled Setup</a></li>
<li><a href="reliable_tx.html">Reliable Transaction Submission</a></li>

View File

@@ -71,8 +71,8 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-apis.html">rippled</a></li>
<li><a href="ripple-rest.html">Ripple-REST</a></li>
@@ -88,7 +88,7 @@
</ul>
</li>
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-setup.html">rippled Setup</a></li>
<li><a href="reliable_tx.html">Reliable Transaction Submission</a></li>

View File

@@ -71,8 +71,8 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-apis.html">rippled</a></li>
<li><a href="ripple-rest.html">Ripple-REST</a></li>
@@ -88,7 +88,7 @@
</ul>
</li>
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-setup.html">rippled Setup</a></li>
<li><a href="reliable_tx.html">Reliable Transaction Submission</a></li>

View File

@@ -71,8 +71,8 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-apis.html">rippled</a></li>
<li><a href="ripple-rest.html">Ripple-REST</a></li>
@@ -88,7 +88,7 @@
</ul>
</li>
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-setup.html">rippled Setup</a></li>
<li><a href="reliable_tx.html">Reliable Transaction Submission</a></li>

View File

@@ -71,8 +71,8 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-apis.html">rippled</a></li>
<li><a href="ripple-rest.html">Ripple-REST</a></li>
@@ -88,7 +88,7 @@
</ul>
</li>
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-setup.html">rippled Setup</a></li>
<li><a href="reliable_tx.html">Reliable Transaction Submission</a></li>

View File

@@ -44,8 +44,8 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-apis.html">rippled</a></li>
<li><a href="ripple-rest.html">Ripple-REST</a></li>
@@ -61,7 +61,7 @@
</ul>
</li>
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-setup.html">rippled Setup</a></li>
<li><a href="reliable_tx.html">Reliable Transaction Submission</a></li>

View File

@@ -57,8 +57,8 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-apis.html">rippled</a></li>
<li><a href="ripple-rest.html">Ripple-REST</a></li>
@@ -74,7 +74,7 @@
</ul>
</li>
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-setup.html">rippled Setup</a></li>
<li><a href="reliable_tx.html">Reliable Transaction Submission</a></li>

View File

@@ -71,8 +71,8 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-apis.html">rippled</a></li>
<li><a href="ripple-rest.html">Ripple-REST</a></li>
@@ -88,7 +88,7 @@
</ul>
</li>
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-setup.html">rippled Setup</a></li>
<li><a href="reliable_tx.html">Reliable Transaction Submission</a></li>

11
pdf_intro.html Normal file
View File

@@ -0,0 +1,11 @@
<!DOCTYPE html>
<html>
<head></head>
<body>
<center>
<h1>Ripple Developer Resources</h1>
<p>(PDF format is experimental only)</p>
<img class="large_logo" src="assets/img/ripple_logo_large.png">
</center>
</body>
</html>

View File

@@ -71,8 +71,8 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-apis.html">rippled</a></li>
<li><a href="ripple-rest.html">Ripple-REST</a></li>
@@ -88,7 +88,7 @@
</ul>
</li>
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-setup.html">rippled Setup</a></li>
<li><a href="reliable_tx.html">Reliable Transaction Submission</a></li>

View File

@@ -44,8 +44,8 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-apis.html">rippled</a></li>
<li><a href="ripple-rest.html">Ripple-REST</a></li>
@@ -61,7 +61,7 @@
</ul>
</li>
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-setup.html">rippled Setup</a></li>
<li><a href="reliable_tx.html">Reliable Transaction Submission</a></li>

View File

@@ -44,8 +44,8 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-apis.html">rippled</a></li>
<li><a href="ripple-rest.html">Ripple-REST</a></li>
@@ -61,7 +61,7 @@
</ul>
</li>
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-setup.html">rippled Setup</a></li>
<li><a href="reliable_tx.html">Reliable Transaction Submission</a></li>

View File

@@ -71,8 +71,8 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-apis.html">rippled</a></li>
<li><a href="ripple-rest.html">Ripple-REST</a></li>
@@ -88,7 +88,7 @@
</ul>
</li>
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-setup.html">rippled Setup</a></li>
<li><a href="reliable_tx.html">Reliable Transaction Submission</a></li>

View File

@@ -71,8 +71,8 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-apis.html">rippled</a></li>
<li><a href="ripple-rest.html">Ripple-REST</a></li>
@@ -88,7 +88,7 @@
</ul>
</li>
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-setup.html">rippled Setup</a></li>
<li><a href="reliable_tx.html">Reliable Transaction Submission</a></li>

View File

@@ -71,8 +71,8 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-apis.html">rippled</a></li>
<li><a href="ripple-rest.html">Ripple-REST</a></li>
@@ -88,7 +88,7 @@
</ul>
</li>
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-setup.html">rippled Setup</a></li>
<li><a href="reliable_tx.html">Reliable Transaction Submission</a></li>

View File

@@ -71,8 +71,8 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-apis.html">rippled</a></li>
<li><a href="ripple-rest.html">Ripple-REST</a></li>
@@ -88,7 +88,7 @@
</ul>
</li>
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-setup.html">rippled Setup</a></li>
<li><a href="reliable_tx.html">Reliable Transaction Submission</a></li>

View File

@@ -1,103 +1,110 @@
[
{
"name": "Overview",
"template":"template-index.html",
"html": "index.html",
"targets": ["local", "ripple.com"]
},
{
"name": "Ripple Developer Resources",
"template":"template-pdf_intro.html",
"html": "pdf_intro.html",
"targets": ["pdf"]
},
{
"name": "rippled",
"md":"rippled.md",
"html":"rippled-apis.html",
"ripple.com": "https://ripple.com/build/rippled-apis/",
"type": "reference"
"category": "References"
},
{
"name": "rippled Setup",
"md":"rippled-setup.md",
"html":"rippled-setup.html",
"ripple.com": "https://ripple.com/build/rippled-setup/",
"type": "tutorial"
"category": "Tutorials"
},
{
"name": "Ripple-REST",
"md": "ripplerest_api.md",
"html": "ripple-rest.html",
"ripple.com": "https://ripple.com/build/ripple-rest/",
"type": "reference"
"category": "References"
},
{
"name": "Transactions",
"md":"tx_format.md",
"html":"transactions.html",
"ripple.com": "https://ripple.com/build/transactions/",
"type": "reference"
"category": "References"
},
{
"name": "Ripple Consensus Ledger",
"md":"ledger_format.md",
"html":"ripple-ledger.html",
"ripple.com": "https://ripple.com/build/ledger-format/",
"type": "reference"
"category": "References"
},
{
"name": "Reliable Transaction Submission",
"md":"reliable_tx.md",
"html":"reliable_tx.html",
"ripple.com": "https://ripple.com/build/reliable-transaction-submission/",
"type": "tutorial"
"category": "Tutorials"
},
{
"name": "Gateway Guide",
"md":"gateway_guide.md",
"html":"gateway_guide.html",
"ripple.com": "https://ripple.com/build/gateway-guide/",
"type": "tutorial"
"category": "Tutorials"
},
{
"name": "Historical Data API",
"md": "historical_data.md",
"html": "historical_data.html",
"ripple.com": "https://ripple.com/build/historical-database/",
"type": "reference"
"category": "References"
},
{
"name": "Ripple Charts API",
"md": "charts_api.md",
"html": "charts_api.html",
"ripple.com": "https://ripple.com/build/charts-api/",
"type": "reference"
"category": "References"
},
{
"name": "Ripple Data API v2",
"md": "data_v2.md",
"html": "data_api_v2.html",
"ripple.com": "https://ripple.com/build/data-api-v2/",
"type": "reference"
"category": "References"
},
{
"name": "Paths",
"md":"paths.md",
"html":"paths.html",
"type": "reference"
"category": "References"
},
{
"name": "Fees (Disambiguation)",
"md": "fees.md",
"html": "fees.html",
"type": "reference"
"category": "References"
},
{
"name": "Transfer Fees",
"md":"transferrate.md",
"html":"transfer_fees.html",
"ripple.com": "https://ripple.com/knowledge_center/transfer-fees/",
"type": "reference"
"category": "References"
},
{
"name": "Transaction Cost",
"md": "tx-cost.md",
"html": "tx-cost.html",
"type": "reference"
},
{
"name": "Overview",
"template":"template-index.html",
"html": "index.html"
"category": "References"
},
{
"name": "Ripple-REST API Tool",
@@ -106,40 +113,45 @@
"is_apitool": true,
"rest_host": "https://api.ripple.com",
"ripple.com": "https://ripple.com/build/rest-tool/",
"html": "rest-api-tool.html"
"html": "rest-api-tool.html",
"targets": ["local","ripple.com"]
},
{
"name": "Historical Database API Tool",
"template":"template-rest-api-tool.html",
"methods_js": "js/apitool-methods-historical.js",
"type": "apitool",
"category": "API Tools",
"rest_host": "https://history.ripple.com",
"ripple.com": "https://ripple.com/build/historical-database-api-tool/",
"html": "historicaldb-api-tool.html"
"html": "historicaldb-api-tool.html",
"targets": ["local","ripple.com"]
},
{
"name": "WebSocket API Tool",
"template":"template-ripple-api-tool.html",
"type": "apitool",
"category": "API Tools",
"ripple.com": "https://ripple.com/build/websocket-tool/",
"html": "ripple-api-tool.html"
"html": "ripple-api-tool.html",
"targets": ["local","ripple.com"]
},
{
"name": "Charts API Tool",
"template":"template-rest-api-tool.html",
"methods_js": "js/apitool-methods-charts.js",
"type": "apitool",
"category": "API Tools",
"rest_host": "https://api.ripplecharts.com",
"ripple.com": "https://ripple.com/build/charts-api-tool/",
"html": "charts-api-tool.html"
"html": "charts-api-tool.html",
"targets": ["local","ripple.com"]
},
{
"name": "Data API v2 Tool",
"template":"template-rest-api-tool.html",
"methods_js": "js/apitool-methods-data_v2.js",
"type": "apitool",
"category": "API Tools",
"rest_host": "https://data.ripple.com",
"html": "data-api-v2-tool.html"
"html": "data-api-v2-tool.html",
"targets": ["local","ripple.com"]
}
]

View File

@@ -30,10 +30,13 @@ PDF_TEMPLATE_FILE = "template-forpdf.html"
PAGE_MANIFEST_FILE = "pages.json"
BUILD_PATH = ".."
CONTENT_PATH = "../content"
BUTTONIZE_FILTER = "buttonize.py"
#BUTTONIZE_FILTER = "buttonize.py"
PRINCE_PAGE_MANIFEST_FILE = "/tmp/devportal-pages.txt"
def parse_markdown(md, environment="local", pages=None):
PDF_TARGET = "pdf"
DEFAULT_TARGET = "local"
def parse_markdown(md, target=DEFAULT_TARGET, pages=None):
## Python markdown requires markdown="1" on HTML block elements
## that contain markdown. AND there's a bug where if you use
## markdown.extensions.extra, it replaces code fences in HTML
@@ -75,19 +78,19 @@ def parse_markdown(md, environment="local", pages=None):
print("done")
#Replace links for live site
if environment != "local":
print("modifying links for environment",environment)
if target != DEFAULT_TARGET:
print("modifying links for target",target)
if not pages:
pages = get_pages()
links = soup.find_all("a",href=re.compile("^[^.]+\.html"))
for link in links:
for page in pages:
if environment in page:
if target in page:
#There's a replacement link for this env
if page["html"] in link["href"]:
link["href"] = link["href"].replace(page["html"],
page[environment])
page[target])
print("done")
print("re-rendering HTML")
@@ -96,15 +99,26 @@ def parse_markdown(md, environment="local", pages=None):
print("done")
return html2
def get_pages():
def get_pages(target=None):
print("reading page manifest...")
with open(PAGE_MANIFEST_FILE) as f:
pages = json.load(f)
if target:
#filter pages that aren't part of this target
pages = [page for page in pages
if "targets" not in page or target in page["targets"]
]
print("done")
return pages
def render_pages(precompiled, pdf=False, environment="local"):
pages = get_pages()
def render_pages(precompiled, target=DEFAULT_TARGET):
pages = get_pages(target)
categories = []#ordered, de-duplicated list
for page in pages:
if "category" in page and page["category"] not in categories:
categories.append(page["category"])
print("categories:",categories)
env = Environment(loader=FileSystemLoader(os.path.curdir))
env.lstrip_blocks = True
@@ -122,18 +136,18 @@ def render_pages(precompiled, pdf=False, environment="local"):
# template_text = f.read()
# doc_template = Template(template_text)
doc_template = env.get_template(DOC_TEMPLATE_FILE)
if pdf:
if target == PDF_TARGET:
doc_template = env.get_template(PDF_TEMPLATE_FILE)
print("done")
if precompiled:
filein = os.path.join(CONTENT_PATH, currentpage["md"])
print("parsing markdown for", currentpage)
print("parsing markdown for", currentpage["name"])
## New markdown module way
with open(filein) as f:
s = f.read()
doc_html = parse_markdown(s, environment, pages)
doc_html = parse_markdown(s, target, pages)
# ## Old Pandoc way
# args = ['pandoc', filein, '-F', BUTTONIZE_FILTER, '-t', 'html']
@@ -143,6 +157,7 @@ def render_pages(precompiled, pdf=False, environment="local"):
print("rendering page",currentpage["name"],"...")
out_html = doc_template.render(currentpage=currentpage,
categories=categories,
pages=pages,
content=doc_html,
precompiled=precompiled)
@@ -153,6 +168,7 @@ def render_pages(precompiled, pdf=False, environment="local"):
print("rendering page",currentpage["name"],"...")
out_html = doc_template.render(currentpage=currentpage,
categories=categories,
pages=pages,
content="",
precompiled=precompiled)
@@ -161,15 +177,14 @@ def render_pages(precompiled, pdf=False, environment="local"):
else:
# Not a documentation page
print("reading template file...")
# with open(currentpage["template"]) as f:
# template_text = f.read()
# template = Template(template_text)
template = env.get_template(currentpage["template"])
print("done")
print("rendering page",currentpage["name"],"...")
out_html = template.render(currentpage=currentpage, pages=pages)
out_html = template.render(currentpage=currentpage,
categories=categories,
pages=pages)
print("done")
@@ -183,14 +198,15 @@ def render_pages(precompiled, pdf=False, environment="local"):
print("done")
def watch(pre_parse, pdf, environment):
def watch(pre_parse, pdf, target):
path = ".."
class UpdaterHandler(PatternMatchingEventHandler):
def on_any_event(self, event):
print("got event!")
if pdf:
make_pdf(pdf)
render_pages(pre_parse, pdf, environment)
render_pages(pre_parse, target)
print("done rendering")
patterns = ["*tool/pages.json","*tool/template-*.html"]
if pre_parse:
@@ -210,24 +226,26 @@ def watch(pre_parse, pdf, environment):
def make_pdf(outfile):
print("rendering PDF-able versions of pages...")
render_pages(True, pdf=outfile)
render_pages(precompiled=True, target=PDF_TARGET)
print("done")
args = ['prince', '-o', outfile, "../index.html"]
pages = get_pages()
args += ["../"+p["html"] for p in pages if "md" in p]
args = ['prince', '-o', outfile]
pages = get_pages(PDF_TARGET)
args += ["../"+p["html"] for p in pages]
print("generating PDF: running ", " ".join(args),"...")
prince_resp = subprocess.check_output(args, universal_newlines=True)
if __name__ == "__main__":
parser = argparse.ArgumentParser(description='Generate static site from markdown and templates.')
parser = argparse.ArgumentParser(
description='Generate static site from markdown and templates.')
parser.add_argument("-p", "--pre_parse", action="store_true",
help="Parse markdown; otherwise, use Flatdoc")
parser.add_argument("-w","--watch", action="store_true",
help="Watch for changes and re-generate the files. This runs until force-quit.")
parser.add_argument("--pdf", type=str, help="Generate a PDF, too. Requires Prince.")
parser.add_argument("--environment", "-e", type=str, default="local",
choices=["local","ripple.com"])
parser.add_argument("--pdf", type=str,
help="Generate a PDF, too. Requires Prince.")
parser.add_argument("--target", "-t", type=str, default=DEFAULT_TARGET,
choices=[DEFAULT_TARGET,"ripple.com"])
args = parser.parse_args()
if args.pdf:
@@ -240,9 +258,9 @@ if __name__ == "__main__":
if args.watch:
print("watching for changes...")
watch(args.pre_parse, args.pdf, args.environment)
watch(args.pre_parse, args.pdf, args.target)
else:
print("rendering pages now")
render_pages(args.pre_parse, environment=args.environment)
render_pages(precompiled=args.pre_parse, target=args.target)
print("all done")

View File

@@ -46,36 +46,18 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
{% for page in pages %}
{% if page.type == "reference" %}
<li><a href="{{ page.html }}">{{ page.name }}</a></li>
{% endif %}
{% endfor %}
</ul>
</li>
{% for cat in categories %}
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">{{cat}} <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
{% for page in pages %}
{% if page.type == "tutorial" %}
{% for page in pages %}
{% if page.category == cat %}
<li><a href="{{ page.html }}">{{ page.name }}</a></li>
{% endif %}
{% endfor %}
</ul>
</li>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">API Tools <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
{% for page in pages %}
{% if page.type == "apitool" %}
<li><a href="{{ page.html }}">{{ page.name }}</a></li>
{% endif %}
{% endfor %}
{% endfor %}
</ul>
</li>
{% endfor %}
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Resources <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">

View File

@@ -0,0 +1,11 @@
<!DOCTYPE html>
<html>
<head></head>
<body>
<center>
<h1>Ripple Developer Resources</h1>
<p>(PDF format is experimental only)</p>
<img class="large_logo" src="assets/img/ripple_logo_large.png">
</center>
</body>
</html>

View File

@@ -71,8 +71,8 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-apis.html">rippled</a></li>
<li><a href="ripple-rest.html">Ripple-REST</a></li>
@@ -88,7 +88,7 @@
</ul>
</li>
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-setup.html">rippled Setup</a></li>
<li><a href="reliable_tx.html">Reliable Transaction Submission</a></li>

View File

@@ -71,8 +71,8 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-apis.html">rippled</a></li>
<li><a href="ripple-rest.html">Ripple-REST</a></li>
@@ -88,7 +88,7 @@
</ul>
</li>
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-setup.html">rippled Setup</a></li>
<li><a href="reliable_tx.html">Reliable Transaction Submission</a></li>

View File

@@ -71,8 +71,8 @@
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">References <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-apis.html">rippled</a></li>
<li><a href="ripple-rest.html">Ripple-REST</a></li>
@@ -88,7 +88,7 @@
</ul>
</li>
<li class="dropdown">
<a href="./" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorials <span class="caret"></span></a>
<ul class="dropdown-menu" role="menu">
<li><a href="rippled-setup.html">rippled Setup</a></li>
<li><a href="reliable_tx.html">Reliable Transaction Submission</a></li>