def join_children(self, path, lang1, c1_list, lang2, c2_list): c_list = [] for i,c1 in enumerate( self.require_identical_list_len(path, lang1, c1_list, lang2, c2_list) ): c2 = c2_list[i] c_path = path + [str(i + 1)] c = {} self.require_identical_dict_keys(c_path, lang1, c1, lang2, c2, ACCEPTED_CHILDREN_DEFAULT_KEYS) key = join_keys(lang1, c1.get('key', ''), lang2, c2.get('key', '')) for k,v in c1.items(): if k == 'key': c[k] = key elif k in ('name', 'title', 'static_content'): c[k] = join_values(lang1, v, lang2, c2.get(k, v)) elif k == 'config': e1 = yaml_writer.read(yaml_writer.file_path(self.app.env, v)) e2 = yaml_writer.read(yaml_writer.file_path(self.app.env, c2.get(k, v))) yaml_writer.write( yaml_writer.file_path(self.app.env, key), self.join_exercises(key, lang1, e1, lang2, e2) ) c[k] = key + '.yaml' elif k == 'children': c[k] = self.join_children(c_path, lang1, v, lang2, c2.get(k, [])) elif deep_equals(v, c2.get(k, v)): c[k] = v else: self.raise_unequal(c_path, lang2, k) c_list.append(c) return c_list
def write(app, exception): ''' Writes the table of contents level configuration. ''' if app.builder.name != 'html': # course configuration YAML is only built with the Sphinx HTML builder # because some parts of the YAML generation have only been implemented # in the visit methods of the HTML builder (aplus_nodes functions # visit_html and depart_html) return if exception: return root = app.env.get_doctree(app.config.master_doc) # Check for language tree. tocs = root.traverse(addnodes.toctree) keys = set() if tocs and tocs[0].get('rawcaption') == u'Select language': app.info('Detected language tree.') indexes = [] for docname, _, doc in traverse_tocs(app, root): i = docname.rfind('_') if i < 0: raise SphinxError( 'Language postfix is required (e.g. docname_en): ' + docname) lang = docname[(i + 1):] app.info( 'Traverse document elements to write configuration index ({}).' .format(lang)) index = make_index(app, doc) yaml_writer.write(yaml_writer.file_path(app.env, 'index_' + lang), index) indexes.append((lang, index)) app.info('Joining language tree to one index.') index = toc_languages.join(app, indexes) append_manual_content(app, index) yaml_writer.write(yaml_writer.file_path(app.env, 'index'), index) keys |= set(m['key'] for m in index['modules']) else: app.info('Traverse document elements to write configuration index.') index = make_index(app, root) append_manual_content(app, index) yaml_writer.write(yaml_writer.file_path(app.env, 'index'), index) keys |= set(m['key'] for m in index['modules']) # Rewrite links for remote inclusion. app.info('Retouch all files to rewrite links.') keys |= {'toc', 'user', 'account'} html_tools.rewrite_outdir(app.outdir, keys, app.config.static_host)
def write_yaml(self, env, name, data_dict, data_type=None): ''' Adds configuration data and requests write into a file. ''' self.set_yaml(data_dict, data_type) self.yaml_write = yaml_writer.file_path(env, name)
def write_yaml(self, env, name, data_dict, data_type=None): ''' Adds configuration data and requests write into a file. ''' self.set_yaml(data_dict, data_type) self.yaml_write = yaml_writer.file_path(env, name)