zealdocs/zeal
1
1
Fork 0
mirror of https://github.com/zealdocs/zeal.git synced 2024-11-30 03:13:56 +03:00
Code Issues Projects Releases Wiki Activity

ExtJS & Sencha Touch docsets - added heading, fixed Dash types, added Dash anchors

Browse Source
This commit is contained in:
Jerzy Kozera 2013-03-17 16:23:50 +00:00
parent 4e1271c6ac
commit 44d97ce80e
1 changed files with 35 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

56
gendocsets/extjs/parse.py
View File

@ -8,14 +8,22 @@ import errno
import os import os
import re import re
from json import loads from json import loads
from lxml.html import parse, tostring from lxml.html import parse, tostring, fromstring
from shutil import copytree, rmtree, copy from shutil import copytree, rmtree, copy
import sqlite3 import sqlite3
INPUT_DIR = '.' INPUT_DIR = '.'
OUTPUT_DIR = os.path.join(INPUT_DIR, 'output') OUTPUT_DIR = os.path.join(INPUT_DIR, 'output')
OUT_DIR = 'ExtJS-4.1.docset' if os.path.exists(os.path.join(INPUT_DIR, 'extjs-build')):
builddir = 'extjs-build'
OUT_DIR = 'ExtJS-4.1.docset'
docsetname = 'ExtJS 4.1'
else:
builddir = 'touch-build'
assert os.path.exists(os.path.join(INPUT_DIR, builddir))
OUT_DIR = 'SenchaTouch-2.1.docset'
docsetname = 'Sencha Touch 2.1'
DOCUMENTS_DIR = os.path.join(OUT_DIR, 'Contents', 'Resources', 'Documents') DOCUMENTS_DIR = os.path.join(OUT_DIR, 'Contents', 'Resources', 'Documents')
HTML_DIR = os.path.join(DOCUMENTS_DIR, 'html') HTML_DIR = os.path.join(DOCUMENTS_DIR, 'html')
@ -24,7 +32,7 @@ copytree(INPUT_DIR, DOCUMENTS_DIR)
# index.html doesn't work with Dash # index.html doesn't work with Dash
rmtree(os.path.join(DOCUMENTS_DIR, 'output')) rmtree(os.path.join(DOCUMENTS_DIR, 'output'))
rmtree(os.path.join(DOCUMENTS_DIR, 'extjs-build')) rmtree(os.path.join(DOCUMENTS_DIR, builddir))
rmtree(os.path.join(DOCUMENTS_DIR, 'guides')) rmtree(os.path.join(DOCUMENTS_DIR, 'guides'))
os.unlink(os.path.join(DOCUMENTS_DIR, 'index.html')) os.unlink(os.path.join(DOCUMENTS_DIR, 'index.html'))
@ -36,20 +44,21 @@ with open(os.path.join(OUT_DIR, 'Contents', 'Info.plist'), 'w') as plist:
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0"> <plist version="1.0">
<dict> <dict>
<key>CFBundleIdentifier</key> <key>CFBundleIdentifier</key>
<string>ExtJS 4.1</string> <string>%s</string>
<key>CFBundleName</key> <key>CFBundleName</key>
<string>ExtJS 4.1</string> <string>%s</string>
<key>DocSetPlatformFamily</key> <key>DocSetPlatformFamily</key>
<string>ExtJS 4.1</string> <string>%s</string>
<key>isDashDocset</key> <key>isDashDocset</key>
<true/> <true/>
</dict> </dict>
</plist>""") </plist>""" % (docsetname, docsetname, docsetname))
conn = sqlite3.connect(os.path.join(OUT_DIR, 'Contents', 'Resources', 'docSet.dsidx')) conn = sqlite3.connect(os.path.join(OUT_DIR, 'Contents', 'Resources', 'docSet.dsidx'))
c = conn.cursor() c = conn.cursor()
c.execute('CREATE TABLE searchIndex (id integer primary key, name text, type text, path text)') c.execute('CREATE TABLE searchIndex (id integer primary key, name text, type text, path text)')
c.execute('CREATE UNIQUE INDEX anchor ON searchIndex (name, type, path);')
ids = {} ids = {}
trees = {} trees = {}
@ -84,7 +93,9 @@ for fname, tree in trees.iteritems():
} }
</style> </style>
</head> </head>
<body><div class="class-overview"><div class="x-panel-body">""") <body>
<span style="font-size:2em; font-weight:bold">%s</span>
<div class="class-overview"><div class="x-panel-body">"""%fname[:-len('.html')])
for a in tree.findall('//a'): for a in tree.findall('//a'):
if 'href' not in a.attrib: continue if 'href' not in a.attrib: continue
@ -92,7 +103,8 @@ for fname, tree in trees.iteritems():
a.attrib['href'] = '../' + a.attrib['href'] a.attrib['href'] = '../' + a.attrib['href']
else: else:
if not a.attrib['href'].startswith('#'): continue if not a.attrib['href'].startswith('#'): continue
if '/guide/' in a.attrib['href'] or '/example' in a.attrib['href']: continue ignore = ['/guide/', '/example/', '/guides/', '/video/']
if any(i in a.attrib['href'] for i in ignore): continue
fragment = a.attrib['href'].replace('#!/api/', '') fragment = a.attrib['href'].replace('#!/api/', '')
def cfg(): def cfg():
@ -120,21 +132,23 @@ for fname, tree in trees.iteritems():
stype = section.find('h3').text stype = section.find('h3').text
try: try:
idxtype = {'Methods': 'clm', idxtype = {'Methods': 'clm',
'Properties': 'Attribute', 'Properties': 'Property',
'Config options': 'Attribute', 'Config options': 'Option',
'Events': 'event', 'Events': 'event',
'CSS Mixins': 'func', 'CSS Mixins': 'Mixin',
'CSS Variables': 'var'}[stype] 'CSS Variables': 'var'}[stype]
except KeyError: except KeyError:
untypes.add(stype) untypes.add(stype)
idxtype = 'unknown' idxtype = 'unknown'
for member in section.find_class('member'): for member in section.find_class('member'):
if member.find_class('defined-in')[0].text != fname[:-len('.html')]: if member.find_class('defined-in')[0].text != fname[:-len('.html')]:
assert member.find_class('defined-in')[0].text + '.html' in trees, member.find_class('defined-in')[0].text assert member.find_class('defined-in')[0].text + '.html' in trees, member.find_class('defined-in')[0].text
continue continue
membername = member.xpath('div[@class="title"]/a/text()')[0]
c.execute('INSERT INTO searchIndex(type, name, path) values(?, ?, ?)', c.execute('INSERT INTO searchIndex(type, name, path) values(?, ?, ?)',
(idxtype, fname[:-len('html')]+member.xpath('div[@class="title"]/a/text()')[0], (idxtype, fname[:-len('html')]+membername,
os.path.join('html', fname)+'#'+member.attrib['id'])) os.path.join('html', fname)+'#'+member.attrib['id']))
member.insert(0, fromstring("<a name='//apple_ref/cpp/%s/%s' class='dashAnchor' />" % (idxtype, membername)))
c.execute('INSERT INTO searchIndex(type, name, path) values("cl", ?, ?)', c.execute('INSERT INTO searchIndex(type, name, path) values("cl", ?, ?)',
(fname[:-len('.html')], os.path.join('html', fname))) (fname[:-len('.html')], os.path.join('html', fname)))