def get_all_patterns():
"""Return a sorted list of all patterns."""
all_patterns = []
for group in s3_patterns.keys():
for pattern in s3_patterns[group]:
all_patterns.append(pattern)
return sorted(all_patterns)
def get_all_patterns():
"""Return a sorted list of all patterns."""
all_patterns = []
for group in s3_patterns.keys():
for pattern in s3_patterns[group]:
all_patterns.append(pattern)
return sorted(all_patterns)
def build_toc_files(args, patterns):
"""(Re-)build all includes with tables of contents."""
create_directory('patterns')
def write_link(fp, link_title, link_path):
fp.write("* [%s](%s)\n" % (link_title, link_path))
def write_toc_include(items, filename, target_prefix=''):
"""Create a table of contents from items and write to filename."""
with file(filename, 'w+') as fp:
for item in items:
write_link(fp, make_title(item),
target_prefix + make_pathname(item) + '.html')
def write_group_master(folder, group):
gpath = make_pathname(group)
with file(os.path.join(folder, '%s--master.md' % gpath), 'w+') as fp:
front_matter(fp, make_title(group))
fp.write('\n{{%s--content.md}}\n' % gpath)
fp.write('\n{{%s--toc.md}}\n' % gpath)
# create /_toc_include.md to be included in the main index
write_toc_include(patterns, 'index--toc.md',
'/patterns/') # root patterns index
write_toc_include(patterns,
os.path.join('patterns',
'all-patterns.md')) # patterns index
write_toc_include(sorted(s3_patterns.keys()),
os.path.join('patterns',
'index--groups--toc.md')) # groups TOC
if args.verbose:
print "\ncopy this to the group indexes section of generate_index_files.sh\n"
# build a TOC for each group
for group in sorted(s3_patterns.keys()):
write_toc_include(
sorted(s3_patterns[group]),
os.path.join('patterns', '%s--toc.md' % make_pathname(group)))
write_group_master('patterns', group)
if args.verbose:
# output multimardown command to create build group index files
print 'multimarkdown --to=mmd --output=patterns/%(group)s--index.md patterns/%(group)s--master.md' % {
'group': make_pathname(group)
}
def build_toc_files(args, patterns):
"""(Re-)build all includes with tables of contents."""
create_directory('patterns')
def write_link(fp, link_title, link_path):
fp.write("* [%s](%s)\n" % (link_title, link_path))
def write_toc_include(items, filename, target_prefix=''):
"""Create a table of contents from items and write to filename."""
with file(filename, 'w+') as fp:
for item in items:
write_link(fp, make_title(item), target_prefix+make_pathname(item)+'.html')
def write_group_master(folder, group):
gpath = make_pathname(group)
with file(os.path.join(folder, '%s--master.md' % gpath), 'w+') as fp:
front_matter(fp, make_title(group))
fp.write('\n{{%s--content.md}}\n' % gpath)
fp.write('\n{{%s--toc.md}}\n' % gpath)
# create /_toc_include.md to be included in the main index
write_toc_include(patterns, 'index--toc.md', '/patterns/') # root patterns index
write_toc_include(patterns, os.path.join('patterns', 'all-patterns.md')) # patterns index
write_toc_include(sorted(s3_patterns.keys()), os.path.join('patterns', 'index--groups--toc.md')) # groups TOC
if args.verbose:
print "\ncopy this to the group indexes section of generate_index_files.sh\n"
# build a TOC for each group
for group in sorted(s3_patterns.keys()):
write_toc_include(sorted(s3_patterns[group]), os.path.join('patterns', '%s--toc.md' % make_pathname(group)))
write_group_master('patterns', group)
if args.verbose:
# output multimardown command to create build group index files
print 'multimarkdown --to=mmd --output=patterns/%(group)s--index.md patterns/%(group)s--master.md' % {'group': make_pathname(group)}
if __name__ == "__main__":
# setup argparse
parser = argparse.ArgumentParser(
description='build files for s3 patterns website and handbooks')
parser.add_argument('--verbose', '-v', action='count')
parser.add_argument(
'--toc',
action='store_true',
help='(re-)build all includes with tables of contents.')
parser.add_argument(
'--skeleton',
action='store_true',
help='build skeleton content files for groups and patterns.')
parser.add_argument('--excluded',
action='store_true',
help='Create exclude list for _config.yaml.')
args = parser.parse_args()
# init
patterns = get_all_patterns()
if args.toc:
build_toc_files(args, patterns)
if args.skeleton:
build_skeleton_files(args, patterns, s3_patterns.keys())
if args.excluded:
list_excluded_files(args, s3_patterns.keys())
for suffix in ['content', 'toc', 'master']:
_print(os.path.join('/patterns', group), suffix)
if __name__ == "__main__":
# setup argparse
parser = argparse.ArgumentParser(description='build files for s3 patterns website and handbooks')
parser.add_argument('--verbose', '-v', action='count')
parser.add_argument('--toc', action='store_true',
help='(re-)build all includes with tables of contents.')
parser.add_argument('--skeleton', action='store_true',
help='build skeleton content files for groups and patterns.')
parser.add_argument('--excluded', action='store_true',
help='Create exclude list for _config.yaml.')
args = parser.parse_args()
# init
patterns = get_all_patterns()
if args.toc:
build_toc_files(args, patterns)
if args.skeleton:
build_skeleton_files(args, patterns, s3_patterns.keys())
if args.excluded:
list_excluded_files(args, s3_patterns.keys())
