205 lines
7.8 KiB
HTML
205 lines
7.8 KiB
HTML
|
|
|||
|
|
<!DOCTYPE html>
|
|||
|
|
|
|||
|
|
<html lang="en">
|
|||
|
|
<head>
|
|||
|
|
<meta charset="utf-8" />
|
|||
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
|
|||
|
|
|
|||
|
|
<title>Introduction — ZAZ documentation</title>
|
|||
|
|
<link rel="stylesheet" type="text/css" href="../_static/pygments.css" />
|
|||
|
|
<link rel="stylesheet" type="text/css" href="../_static/alabaster.css" />
|
|||
|
|
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
|
|||
|
|
<script src="../_static/jquery.js"></script>
|
|||
|
|
<script src="../_static/underscore.js"></script>
|
|||
|
|
<script src="../_static/doctools.js"></script>
|
|||
|
|
<link rel="index" title="Index" href="../genindex.html" />
|
|||
|
|
<link rel="search" title="Search" href="../search.html" />
|
|||
|
|
<link rel="next" title="Configuration" href="config.html" />
|
|||
|
|
<link rel="prev" title="Welcome to ZAZ’s documentation!" href="../index.html" />
|
|||
|
|
|
|||
|
|
<link rel="stylesheet" href="../_static/custom.css" type="text/css" />
|
|||
|
|
|
|||
|
|
|
|||
|
|
<meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
|
|||
|
|
|
|||
|
|
</head><body>
|
|||
|
|
|
|||
|
|
|
|||
|
|
<div class="document">
|
|||
|
|
<div class="documentwrapper">
|
|||
|
|
<div class="bodywrapper">
|
|||
|
|
|
|||
|
|
|
|||
|
|
<div class="body" role="main">
|
|||
|
|
|
|||
|
|
<section id="introduction">
|
|||
|
|
<h1>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h1>
|
|||
|
|
<section id="overview">
|
|||
|
|
<h2>Overview<a class="headerlink" href="#overview" title="Permalink to this headline">¶</a></h2>
|
|||
|
|
<p>ZAZ is a script for rapid develop extensions and macros for <a class="reference external" href="https://libreoffice.org">LibreOffice</a>, in
|
|||
|
|
<a class="reference external" href="https://python.org">Python</a> of course.</p>
|
|||
|
|
<p>With ZAZ, you can create:</p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>Extensions for final user</p></li>
|
|||
|
|
<li><p>New components for used from Basic</p></li>
|
|||
|
|
<li><p>AddIn, new functions for Calc</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</section>
|
|||
|
|
<section id="requirements">
|
|||
|
|
<h2>Requirements<a class="headerlink" href="#requirements" title="Permalink to this headline">¶</a></h2>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>Python 3.7+</p></li>
|
|||
|
|
<li><p>LibreOffice 7.0+ with support for macros Python</p></li>
|
|||
|
|
<li><p>LibreOffice SDK, for new components and Add-In</p></li>
|
|||
|
|
</ul>
|
|||
|
|
<p>In:</p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><dl class="simple">
|
|||
|
|
<dt>ArchLinux</dt><dd><ul>
|
|||
|
|
<li><p><code class="docutils literal notranslate"><span class="pre">sudo</span> <span class="pre">pacman</span> <span class="pre">-S</span> <span class="pre">libreoffice-fresh-sdk</span></code></p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</li>
|
|||
|
|
<li><dl class="simple">
|
|||
|
|
<dt>Ubuntu 20.04+</dt><dd><ul>
|
|||
|
|
<li><p><code class="docutils literal notranslate"><span class="pre">sudo</span> <span class="pre">apt</span> <span class="pre">install</span> <span class="pre">libreoffice-script-provider-python</span> <span class="pre">libreoffice-dev</span></code></p></li>
|
|||
|
|
</ul>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</li>
|
|||
|
|
</ul>
|
|||
|
|
</section>
|
|||
|
|
<section id="installation">
|
|||
|
|
<h2>Installation<a class="headerlink" href="#installation" title="Permalink to this headline">¶</a></h2>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>Clone this repository (recommended) or download it.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
<p><code class="docutils literal notranslate"><span class="pre">git</span> <span class="pre">clone</span> <span class="pre">https://git.cuates.net/elmau/zaz.git</span></code></p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>Move to.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
<p><code class="docutils literal notranslate"><span class="pre">cd</span> <span class="pre">zaz/source</span></code></p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>Start new extension.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
<p><code class="docutils literal notranslate"><span class="pre">./zaz.py</span> <span class="pre">-new</span> <span class="pre">-t</span> <span class="pre">~/projects</span> <span class="pre">-n</span> <span class="pre">MyFirstExtension</span></code></p>
|
|||
|
|
</section>
|
|||
|
|
<section id="my-first-extension">
|
|||
|
|
<h2>My first extension<a class="headerlink" href="#my-first-extension" title="Permalink to this headline">¶</a></h2>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>Move to:</p></li>
|
|||
|
|
</ul>
|
|||
|
|
<p><code class="docutils literal notranslate"><span class="pre">cd</span> <span class="pre">~/projects/MyFirstExtension</span></code></p>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>Create:</p></li>
|
|||
|
|
</ul>
|
|||
|
|
<p><code class="docutils literal notranslate"><span class="pre">python</span> <span class="pre">zaz.py</span> <span class="pre">-c</span></code>:</p>
|
|||
|
|
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>↪ python zaz.py -c
|
|||
|
|
04/02/2021 23:07:50 - INFO - Created directories...
|
|||
|
|
04/02/2021 23:07:50 - INFO - Created files...
|
|||
|
|
04/02/2021 23:07:50 - INFO - Don't forget generate DOMAIN.pot for locales
|
|||
|
|
04/02/2021 23:07:50 - INFO - New extension: MyFirstExtension make successfully...
|
|||
|
|
Now, you can install and test: zaz.py -i
|
|||
|
|
</pre></div>
|
|||
|
|
</div>
|
|||
|
|
<ul class="simple">
|
|||
|
|
<li><p>Install and test:</p></li>
|
|||
|
|
</ul>
|
|||
|
|
<p><code class="docutils literal notranslate"><span class="pre">python</span> <span class="pre">zaz.py</span> <span class="pre">-i</span></code>:</p>
|
|||
|
|
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>↪ python zaz.py -i
|
|||
|
|
04/02/2021 23:11:40 - INFO - Don't forget generate DOMAIN.pot for locales
|
|||
|
|
04/02/2021 23:11:40 - INFO - Compress OXT extension...
|
|||
|
|
04/02/2021 23:11:40 - INFO - Extension OXT created successfully...
|
|||
|
|
Copying: MyFirstExtension_v0.1.0.oxt
|
|||
|
|
|
|||
|
|
unopkg done.
|
|||
|
|
|
|||
|
|
04/02/2021 23:11:41 - INFO - Install extension successfully...
|
|||
|
|
04/02/2021 23:11:41 - INFO - Start LibreOffice...
|
|||
|
|
04/02/2021 23:11:53 - INFO - Extension make successfully...
|
|||
|
|
</pre></div>
|
|||
|
|
</div>
|
|||
|
|
</section>
|
|||
|
|
</section>
|
|||
|
|
|
|||
|
|
|
|||
|
|
</div>
|
|||
|
|
|
|||
|
|
</div>
|
|||
|
|
</div>
|
|||
|
|
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
|
|||
|
|
<div class="sphinxsidebarwrapper">
|
|||
|
|
<h1 class="logo"><a href="../index.html">ZAZ</a></h1>
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
<h3>Navigation</h3>
|
|||
|
|
<p class="caption"><span class="caption-text">Contents:</span></p>
|
|||
|
|
<ul class="current">
|
|||
|
|
<li class="toctree-l1 current"><a class="current reference internal" href="#">Introduction</a><ul>
|
|||
|
|
<li class="toctree-l2"><a class="reference internal" href="#overview">Overview</a></li>
|
|||
|
|
<li class="toctree-l2"><a class="reference internal" href="#requirements">Requirements</a></li>
|
|||
|
|
<li class="toctree-l2"><a class="reference internal" href="#installation">Installation</a></li>
|
|||
|
|
<li class="toctree-l2"><a class="reference internal" href="#my-first-extension">My first extension</a></li>
|
|||
|
|
</ul>
|
|||
|
|
</li>
|
|||
|
|
<li class="toctree-l1"><a class="reference internal" href="config.html">Configuration</a></li>
|
|||
|
|
<li class="toctree-l1"><a class="reference internal" href="easymacro.html">Library easymacro.py</a></li>
|
|||
|
|
<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
|
|||
|
|
</ul>
|
|||
|
|
|
|||
|
|
<div class="relations">
|
|||
|
|
<h3>Related Topics</h3>
|
|||
|
|
<ul>
|
|||
|
|
<li><a href="../index.html">Documentation overview</a><ul>
|
|||
|
|
<li>Previous: <a href="../index.html" title="previous chapter">Welcome to ZAZ’s documentation!</a></li>
|
|||
|
|
<li>Next: <a href="config.html" title="next chapter">Configuration</a></li>
|
|||
|
|
</ul></li>
|
|||
|
|
</ul>
|
|||
|
|
</div>
|
|||
|
|
<div id="searchbox" style="display: none" role="search">
|
|||
|
|
<h3 id="searchlabel">Quick search</h3>
|
|||
|
|
<div class="searchformwrapper">
|
|||
|
|
<form class="search" action="../search.html" method="get">
|
|||
|
|
<input type="text" name="q" aria-labelledby="searchlabel" />
|
|||
|
|
<input type="submit" value="Go" />
|
|||
|
|
</form>
|
|||
|
|
</div>
|
|||
|
|
</div>
|
|||
|
|
<script>$('#searchbox').show(0);</script>
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
</div>
|
|||
|
|
</div>
|
|||
|
|
<div class="clearer"></div>
|
|||
|
|
</div>
|
|||
|
|
<div class="footer">
|
|||
|
|
©2021, Mauricio Baeza.
|
|||
|
|
|
|||
|
|
|
|
|||
|
|
Powered by <a href="http://sphinx-doc.org/">Sphinx 4.0.2</a>
|
|||
|
|
& <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
|
|||
|
|
|
|||
|
|
|
|
|||
|
|
<a href="../_sources/main/intro.rst.txt"
|
|||
|
|
rel="nofollow">Page source</a>
|
|||
|
|
</div>
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
</body>
|
|||
|
|
</html>
|