/usr/share/doc/python-django-sitetree-doc/html/thirdparty.html is in python-django-sitetree-doc 1.7.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Thirdparty applications support — django-sitetree 1.7.0 documentation</title>
<link rel="stylesheet" href="_static/classic.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '1.7.0',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="top" title="django-sitetree 1.7.0 documentation" href="index.html" />
<link rel="prev" title="Thirdparty addons" href="addons.html" />
</head>
<body role="document">
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="addons.html" title="Thirdparty addons"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">django-sitetree 1.7.0 documentation</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="thirdparty-applications-support">
<h1>Thirdparty applications support<a class="headerlink" href="#thirdparty-applications-support" title="Permalink to this headline">¶</a></h1>
<p>Here belongs some notes on thirdparty Django applications support in SiteTree.</p>
<div class="section" id="django-smuggler">
<h2>django-smuggler<a class="headerlink" href="#django-smuggler" title="Permalink to this headline">¶</a></h2>
<p><a class="reference external" href="https://pypi.python.org/pypi/django-smuggler/">https://pypi.python.org/pypi/django-smuggler/</a></p>
<p><cite>Smuggler</cite> dump and load buttons will be available on trees listing page if this app is installed
allowing to dump and load site trees and items right from your browser.</p>
</div>
<div class="section" id="django-modeltranslation">
<h2>django-modeltranslation<a class="headerlink" href="#django-modeltranslation" title="Permalink to this headline">¶</a></h2>
<p><a class="reference external" href="https://pypi.python.org/pypi/django-modeltranslation/">https://pypi.python.org/pypi/django-modeltranslation/</a></p>
<p>If you do not want to use the built-in <cite>sitetree</cite> Internationalization machinery, with <cite>modeltranslation</cite> you can
localize your tree items into different languages. This requires some work though.</p>
<ol class="arabic simple">
<li>Create a custom sitetree item model:</li>
</ol>
<div class="highlight-python"><div class="highlight"><pre><span></span><span class="c1"># models.py of some of your apps (e.g. myapp).</span>
<span class="kn">from</span> <span class="nn">sitetree.models</span> <span class="kn">import</span> <span class="n">TreeItemBase</span>
<span class="k">class</span> <span class="nc">MyTranslatableTreeItem</span><span class="p">(</span><span class="n">TreeItemBase</span><span class="p">):</span>
<span class="sd">"""This model will be used by modeltranslation."""</span>
</pre></div>
</div>
<ol class="arabic simple" start="2">
<li>Instruct Django to use your custom model:</li>
</ol>
<div class="highlight-python"><div class="highlight"><pre><span></span><span class="c1"># setting.py of your project.</span>
<span class="n">SITETREE_MODEL_TREE_ITEM</span> <span class="o">=</span> <span class="s1">'myapp.MyTreeItem'</span>
</pre></div>
</div>
<ol class="arabic simple" start="3">
<li>Tune up Admin contrib to handle translatable tree items:</li>
</ol>
<div class="highlight-python"><div class="highlight"><pre><span></span><span class="c1"># admin.py of your application with translatable tree item model.</span>
<span class="kn">from</span> <span class="nn">modeltranslation.admin</span> <span class="kn">import</span> <span class="n">TranslationAdmin</span>
<span class="kn">from</span> <span class="nn">sitetree.admin</span> <span class="kn">import</span> <span class="n">TreeItemAdmin</span><span class="p">,</span> <span class="n">override_item_admin</span>
<span class="k">class</span> <span class="nc">CustomTreeItemAdmin</span><span class="p">(</span><span class="n">TreeItemAdmin</span><span class="p">,</span> <span class="n">TranslationAdmin</span><span class="p">):</span>
<span class="sd">"""This allows admin contrib to support translations for tree items."""</span>
<span class="n">override_item_admin</span><span class="p">(</span><span class="n">CustomTreeItemAdmin</span><span class="p">)</span>
</pre></div>
</div>
<ol class="arabic simple" start="4">
<li>Instruct <cite>modeltranslation</cite> how to handle your tree item model:</li>
</ol>
<div class="highlight-python"><div class="highlight"><pre><span></span><span class="c1"># translation.py of your application.</span>
<span class="kn">from</span> <span class="nn">modeltranslation.translator</span> <span class="kn">import</span> <span class="n">translator</span><span class="p">,</span> <span class="n">TranslationOptions</span>
<span class="kn">from</span> <span class="nn">.models</span> <span class="kn">import</span> <span class="n">MyTranslatableTreeItem</span>
<span class="k">class</span> <span class="nc">TreeItemTranslationOptions</span><span class="p">(</span><span class="n">TranslationOptions</span><span class="p">):</span>
<span class="c1"># These fields are for translation.</span>
<span class="n">fields</span> <span class="o">=</span> <span class="p">(</span><span class="s1">'title'</span><span class="p">,</span> <span class="s1">'hint'</span><span class="p">,</span> <span class="s1">'description'</span><span class="p">)</span>
<span class="n">translator</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="n">MyTreeItem</span><span class="p">,</span> <span class="n">TreeItemTranslationOptions</span><span class="p">)</span>
</pre></div>
</div>
<p>That’s how you made <cite>sitetree</cite> work with <cite>modeltranslation</cite>.</p>
<p>Read <cite>django-modeltranslation</cite> documentation for more information on tuning.</p>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Thirdparty applications support</a><ul>
<li><a class="reference internal" href="#django-smuggler">django-smuggler</a></li>
<li><a class="reference internal" href="#django-modeltranslation">django-modeltranslation</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="addons.html"
title="previous chapter">Thirdparty addons</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/thirdparty.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<div><input type="text" name="q" /></div>
<div><input type="submit" value="Go" /></div>
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="addons.html" title="Thirdparty addons"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">django-sitetree 1.7.0 documentation</a> »</li>
</ul>
</div>
<div class="footer" role="contentinfo">
© Copyright 2011-2016, Igor 'idle sign' Starikov.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.4.9.
</div>
</body>
</html>
|