free
/
freedomboneeee
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Extra packages example

This commit is contained in:
Bob Mottram 2018-05-14 19:45:13 +01:00
parent e1574b49c1
commit 40f6ed2c26
2 changed files with 151 additions and 66 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
doc/EN/devguide.org
View File

@ -18,10 +18,11 @@ Suppose you have some internet application which you want to add to the system.
There's a command which you can use to generate scripts for new apps. Some examples are as follows: There's a command which you can use to generate scripts for new apps. Some examples are as follows:
To create a script for a generic PHP plus MySql/MariaDB web app: To create a script for a generic PHP plus MySql/MariaDB web app with a couple of extra packages:
#+begin_src bash #+begin_src bash
freedombone-template --app [name] -e [email] -r [repo url] \ freedombone-template --app [name] -e [email] -r [repo url] \
--packages "cowsay libssl-dev" \
-c [commit] --php yes -d mariadb > \ -c [commit] --php yes -d mariadb > \
src/freedombone-app-myappname src/freedombone-app-myappname
#+end_src #+end_src

202
website/EN/devguide.html
View File

@ -3,26 +3,33 @@
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"> <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head> <head>
<title></title> <!-- 2018-05-14 Mon 19:43 -->
<!-- 2018-04-12 Thu 18:23 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" /> <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="generator" content="Org-mode" /> <meta name="viewport" content="width=device-width, initial-scale=1" />
<title>&lrm;</title>
<meta name="generator" content="Org mode" />
<meta name="author" content="Bob Mottram" /> <meta name="author" content="Bob Mottram" />
<meta name="description" content="Freedombone developers guide" <meta name="description" content="Freedombone developers guide"
/> />
<meta name="keywords" content="freedombone, developers" /> <meta name="keywords" content="freedombone, developers" />
<style type="text/css"> <style type="text/css">
<!--/*--><![CDATA[/*><!--*/ <!--/*--><![CDATA[/*><!--*/
.title { text-align: center; } .title { text-align: center;
margin-bottom: .2em; }
.subtitle { text-align: center;
font-size: medium;
font-weight: bold;
margin-top:0; }
.todo { font-family: monospace; color: red; } .todo { font-family: monospace; color: red; }
.done { color: green; } .done { font-family: monospace; color: green; }
.priority { font-family: monospace; color: orange; }
.tag { background-color: #eee; font-family: monospace; .tag { background-color: #eee; font-family: monospace;
padding: 2px; font-size: 80%; font-weight: normal; } padding: 2px; font-size: 80%; font-weight: normal; }
.timestamp { color: #bebebe; } .timestamp { color: #bebebe; }
.timestamp-kwd { color: #5f9ea0; } .timestamp-kwd { color: #5f9ea0; }
.right { margin-left: auto; margin-right: 0px; text-align: right; } .org-right { margin-left: auto; margin-right: 0px; text-align: right; }
.left { margin-left: 0px; margin-right: auto; text-align: left; } .org-left { margin-left: 0px; margin-right: auto; text-align: left; }
.center { margin-left: auto; margin-right: auto; text-align: center; } .org-center { margin-left: auto; margin-right: auto; text-align: center; }
.underline { text-decoration: underline; } .underline { text-decoration: underline; }
#postamble p, #preamble p { font-size: 90%; margin: .2em; } #postamble p, #preamble p { font-size: 90%; margin: .2em; }
p.verse { margin-left: 3%; } p.verse { margin-left: 3%; }
@ -49,27 +56,111 @@
border: 1px solid black; border: 1px solid black;
} }
pre.src:hover:before { display: inline;} pre.src:hover:before { display: inline;}
pre.src-sh:before { content: 'sh'; } /* Languages per Org manual */
pre.src-bash:before { content: 'sh'; } pre.src-asymptote:before { content: 'Asymptote'; }
pre.src-awk:before { content: 'Awk'; }
pre.src-C:before { content: 'C'; }
/* pre.src-C++ doesn't work in CSS */
pre.src-clojure:before { content: 'Clojure'; }
pre.src-css:before { content: 'CSS'; }
pre.src-D:before { content: 'D'; }
pre.src-ditaa:before { content: 'ditaa'; }
pre.src-dot:before { content: 'Graphviz'; }
pre.src-calc:before { content: 'Emacs Calc'; }
pre.src-emacs-lisp:before { content: 'Emacs Lisp'; } pre.src-emacs-lisp:before { content: 'Emacs Lisp'; }
pre.src-R:before { content: 'R'; } pre.src-fortran:before { content: 'Fortran'; }
pre.src-perl:before { content: 'Perl'; } pre.src-gnuplot:before { content: 'gnuplot'; }
pre.src-haskell:before { content: 'Haskell'; }
pre.src-hledger:before { content: 'hledger'; }
pre.src-java:before { content: 'Java'; } pre.src-java:before { content: 'Java'; }
pre.src-js:before { content: 'Javascript'; }
pre.src-latex:before { content: 'LaTeX'; }
pre.src-ledger:before { content: 'Ledger'; }
pre.src-lisp:before { content: 'Lisp'; }
pre.src-lilypond:before { content: 'Lilypond'; }
pre.src-lua:before { content: 'Lua'; }
pre.src-matlab:before { content: 'MATLAB'; }
pre.src-mscgen:before { content: 'Mscgen'; }
pre.src-ocaml:before { content: 'Objective Caml'; }
pre.src-octave:before { content: 'Octave'; }
pre.src-org:before { content: 'Org mode'; }
pre.src-oz:before { content: 'OZ'; }
pre.src-plantuml:before { content: 'Plantuml'; }
pre.src-processing:before { content: 'Processing.js'; }
pre.src-python:before { content: 'Python'; }
pre.src-R:before { content: 'R'; }
pre.src-ruby:before { content: 'Ruby'; }
pre.src-sass:before { content: 'Sass'; }
pre.src-scheme:before { content: 'Scheme'; }
pre.src-screen:before { content: 'Gnu Screen'; }
pre.src-sed:before { content: 'Sed'; }
pre.src-sh:before { content: 'shell'; }
pre.src-sql:before { content: 'SQL'; } pre.src-sql:before { content: 'SQL'; }
pre.src-sqlite:before { content: 'SQLite'; }
/* additional languages in org.el's org-babel-load-languages alist */
pre.src-forth:before { content: 'Forth'; }
pre.src-io:before { content: 'IO'; }
pre.src-J:before { content: 'J'; }
pre.src-makefile:before { content: 'Makefile'; }
pre.src-maxima:before { content: 'Maxima'; }
pre.src-perl:before { content: 'Perl'; }
pre.src-picolisp:before { content: 'Pico Lisp'; }
pre.src-scala:before { content: 'Scala'; }
pre.src-shell:before { content: 'Shell Script'; }
pre.src-ebnf2ps:before { content: 'ebfn2ps'; }
/* additional language identifiers per "defun org-babel-execute"
in ob-*.el */
pre.src-cpp:before { content: 'C++'; }
pre.src-abc:before { content: 'ABC'; }
pre.src-coq:before { content: 'Coq'; }
pre.src-groovy:before { content: 'Groovy'; }
/* additional language identifiers from org-babel-shell-names in
ob-shell.el: ob-shell is the only babel language using a lambda to put
the execution function name together. */
pre.src-bash:before { content: 'bash'; }
pre.src-csh:before { content: 'csh'; }
pre.src-ash:before { content: 'ash'; }
pre.src-dash:before { content: 'dash'; }
pre.src-ksh:before { content: 'ksh'; }
pre.src-mksh:before { content: 'mksh'; }
pre.src-posh:before { content: 'posh'; }
/* Additional Emacs modes also supported by the LaTeX listings package */
pre.src-ada:before { content: 'Ada'; }
pre.src-asm:before { content: 'Assembler'; }
pre.src-caml:before { content: 'Caml'; }
pre.src-delphi:before { content: 'Delphi'; }
pre.src-html:before { content: 'HTML'; }
pre.src-idl:before { content: 'IDL'; }
pre.src-mercury:before { content: 'Mercury'; }
pre.src-metapost:before { content: 'MetaPost'; }
pre.src-modula-2:before { content: 'Modula-2'; }
pre.src-pascal:before { content: 'Pascal'; }
pre.src-ps:before { content: 'PostScript'; }
pre.src-prolog:before { content: 'Prolog'; }
pre.src-simula:before { content: 'Simula'; }
pre.src-tcl:before { content: 'tcl'; }
pre.src-tex:before { content: 'TeX'; }
pre.src-plain-tex:before { content: 'Plain TeX'; }
pre.src-verilog:before { content: 'Verilog'; }
pre.src-vhdl:before { content: 'VHDL'; }
pre.src-xml:before { content: 'XML'; }
pre.src-nxml:before { content: 'XML'; }
/* add a generic configuration mode; LaTeX export needs an additional
(add-to-list 'org-latex-listings-langs '(conf " ")) in .emacs */
pre.src-conf:before { content: 'Configuration File'; }
table { border-collapse:collapse; } table { border-collapse:collapse; }
caption.t-above { caption-side: top; } caption.t-above { caption-side: top; }
caption.t-bottom { caption-side: bottom; } caption.t-bottom { caption-side: bottom; }
td, th { vertical-align:top; } td, th { vertical-align:top; }
th.right { text-align: center; } th.org-right { text-align: center; }
th.left { text-align: center; } th.org-left { text-align: center; }
th.center { text-align: center; } th.org-center { text-align: center; }
td.right { text-align: right; } td.org-right { text-align: right; }
td.left { text-align: left; } td.org-left { text-align: left; }
td.center { text-align: center; } td.org-center { text-align: center; }
dt { font-weight: bold; } dt { font-weight: bold; }
.footpara:nth-child(2) { display: inline; } .footpara { display: inline; }
.footpara { display: block; }
.footdef { margin-bottom: 1em; } .footdef { margin-bottom: 1em; }
.figure { padding: 1em; } .figure { padding: 1em; }
.figure p { text-align: center; } .figure p { text-align: center; }
@ -89,6 +180,7 @@
{ font-size: 10px; font-weight: bold; white-space: nowrap; } { font-size: 10px; font-weight: bold; white-space: nowrap; }
.org-info-js_search-highlight .org-info-js_search-highlight
{ background-color: #ffff00; color: #000000; font-weight: bold; } { background-color: #ffff00; color: #000000; font-weight: bold; }
.org-svg { width: 90%; }
/*]]>*/--> /*]]>*/-->
</style> </style>
<link rel="stylesheet" type="text/css" href="freedombone.css" /> <link rel="stylesheet" type="text/css" href="freedombone.css" />
@ -97,7 +189,7 @@
@licstart The following is the entire license notice for the @licstart The following is the entire license notice for the
JavaScript code in this tag. JavaScript code in this tag.
Copyright (C) 2012-2013 Free Software Foundation, Inc. Copyright (C) 2012-2017 Free Software Foundation, Inc.
The JavaScript code in this tag is free software: you can The JavaScript code in this tag is free software: you can
redistribute it and/or modify it under the terms of the GNU redistribute it and/or modify it under the terms of the GNU
@ -144,28 +236,27 @@ for the JavaScript code in this tag.
<a name="top" id="top"></a> <a name="top" id="top"></a>
</div> </div>
<div id="content"> <div id="content">
<h1 class="title"></h1>
<div class="figure"> <div class="figure">
<p><img src="images/logo.png" alt="logo.png" width="80%" height="10%" align="center" /> <p><img src="images/logo.png" alt="logo.png" width="80%" height="10%" align="center" />
</p> </p>
</div> </div>
<div id="outline-container-sec-1" class="outline-2"> <div id="outline-container-orgd0bf853" class="outline-2">
<h2 id="sec-1">Developers Guide</h2> <h2 id="orgd0bf853">Developers Guide</h2>
</div> </div>
<div id="outline-container-sec-2" class="outline-2"> <div id="outline-container-orgaedd476" class="outline-2">
<h2 id="sec-2">Introduction</h2> <h2 id="orgaedd476">Introduction</h2>
<div class="outline-text-2" id="text-2"> <div class="outline-text-2" id="text-orgaedd476">
<p> <p>
Freedombone consists of a set of bash scripts. There are a lot of them, but they're not very complicated. If you're familiar with the GNU/Linux commandline and can hack a bash script then you can probably add a new app or fix a bug in the system. There are no trendy development frameworks to learn or to get in your way. You might also want to consult the <a href="./codeofconduct.html">Code of Conduct</a>, and there is a Matrix room at <b>#fbone:matrix.freedombone.net</b> Freedombone consists of a set of bash scripts. There are a lot of them, but they're not very complicated. If you're familiar with the GNU/Linux commandline and can hack a bash script then you can probably add a new app or fix a bug in the system. There are no trendy development frameworks to learn or to get in your way. You might also want to consult the <a href="./codeofconduct.html">Code of Conduct</a>, and there is a Matrix room at <b>#fbone:matrix.freedombone.net</b>
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-sec-3" class="outline-2"> <div id="outline-container-org3e1ecd6" class="outline-2">
<h2 id="sec-3">Adding extra apps</h2> <h2 id="org3e1ecd6">Adding extra apps</h2>
<div class="outline-text-2" id="text-3"> <div class="outline-text-2" id="text-org3e1ecd6">
<p> <p>
Suppose you have some internet application which you want to add to the system. To do this you need to create an app script which tells the system how to install/remove and also backup/restore. The script should be designed to work with the current stable version of Debian. Suppose you have some internet application which you want to add to the system. To do this you need to create an app script which tells the system how to install/remove and also backup/restore. The script should be designed to work with the current stable version of Debian.
</p> </p>
@ -175,13 +266,13 @@ There's a command which you can use to generate scripts for new apps. Some examp
</p> </p>
<p> <p>
To create a script for a generic PHP plus MySql/MariaDB web app: To create a script for a generic PHP plus MySql/MariaDB web app with a couple of extra packages:
</p> </p>
<div class="org-src-container"> <div class="org-src-container">
<pre class="src src-bash">freedombone-template --app [name] -e [email] -r [repo url] <span class="org-sh-escaped-newline">\</span>
<pre class="src src-bash">freedombone-template --app [name] -e [email] -r [repo url] \ --packages <span class="org-string">"cowsay libssl-dev"</span> <span class="org-sh-escaped-newline">\</span>
-c [commit] --php yes -d mariadb &gt; \ -c [commit] --php yes -d mariadb &gt; <span class="org-sh-escaped-newline">\</span>
src/freedombone-app-myappname src/freedombone-app-myappname
</pre> </pre>
</div> </div>
@ -191,10 +282,9 @@ For a Nodejs app with MySql/MariaDB database:
</p> </p>
<div class="org-src-container"> <div class="org-src-container">
<pre class="src src-bash">freedombone-template --app [name] -e [email] -r [repo url] <span class="org-sh-escaped-newline">\</span>
<pre class="src src-bash">freedombone-template --app [name] -e [email] -r [repo url] \ -c [commit] --node yes -d mariadb <span class="org-sh-escaped-newline">\</span>
-c [commit] --node yes -d mariadb \ --dir /etc/myappname --daemon yes &gt; <span class="org-sh-escaped-newline">\</span>
--dir /etc/myappname --daemon yes &gt; \
src/freedombone-app-myappname src/freedombone-app-myappname
</pre> </pre>
</div> </div>
@ -204,10 +294,9 @@ For a Python app with Postgresql database:
</p> </p>
<div class="org-src-container"> <div class="org-src-container">
<pre class="src src-bash">freedombone-template --app [name] -e [email] -r [repo url] <span class="org-sh-escaped-newline">\</span>
<pre class="src src-bash">freedombone-template --app [name] -e [email] -r [repo url] \ -c [commit] -d postgresql <span class="org-sh-escaped-newline">\</span>
-c [commit] -d postgresql \ --dir /etc/myappname --daemon yes &gt; <span class="org-sh-escaped-newline">\</span>
--dir /etc/myappname --daemon yes &gt; \
src/freedombone-app-myappname src/freedombone-app-myappname
</pre> </pre>
</div> </div>
@ -217,10 +306,9 @@ For a Python app without any database, communicating between the daemon and the
</p> </p>
<div class="org-src-container"> <div class="org-src-container">
<pre class="src src-bash">freedombone-template --app [name] -e [email] -r [repo url] <span class="org-sh-escaped-newline">\</span>
<pre class="src src-bash">freedombone-template --app [name] -e [email] -r [repo url] \ -c [commit] --dir /etc/myappname <span class="org-sh-escaped-newline">\</span>
-c [commit] --dir /etc/myappname \ --daemon yes --portinternal 1234 &gt; <span class="org-sh-escaped-newline">\</span>
--daemon yes --portinternal 1234 &gt; \
src/freedombone-app-myappname src/freedombone-app-myappname
</pre> </pre>
</div> </div>
@ -230,10 +318,9 @@ For an app without any database which communicates directly on a particular port
</p> </p>
<div class="org-src-container"> <div class="org-src-container">
<pre class="src src-bash">freedombone-template --app [name] -e [email] -r [repo url] <span class="org-sh-escaped-newline">\</span>
<pre class="src src-bash">freedombone-template --app [name] -e [email] -r [repo url] \ -c [commit] --dir /etc/myappname <span class="org-sh-escaped-newline">\</span>
-c [commit] --dir /etc/myappname \ --daemon yes --port 5000 &gt; <span class="org-sh-escaped-newline">\</span>
--daemon yes --port 5000 &gt; \
src/freedombone-app-myappname src/freedombone-app-myappname
</pre> </pre>
</div> </div>
@ -243,10 +330,9 @@ A generic PHP plus MySql/MariaDB web app which is only available on an onion add
</p> </p>
<div class="org-src-container"> <div class="org-src-container">
<pre class="src src-bash">freedombone-template --app [name] -e [email] -r [repo url] <span class="org-sh-escaped-newline">\</span>
<pre class="src src-bash">freedombone-template --app [name] -e [email] -r [repo url] \ -c [commit] --php yes -d mariadb <span class="org-sh-escaped-newline">\</span>
-c [commit] --php yes -d mariadb \ --onion yes &gt; <span class="org-sh-escaped-newline">\</span>
--onion yes &gt; \
src/freedombone-app-myappname src/freedombone-app-myappname
</pre> </pre>
</div> </div>
@ -256,7 +342,6 @@ For more details see the manpage:
</p> </p>
<div class="org-src-container"> <div class="org-src-container">
<pre class="src src-bash">man freedombone-template <pre class="src src-bash">man freedombone-template
</pre> </pre>
</div> </div>
@ -270,7 +355,6 @@ When your new script is ready for testing you can install it with:
</p> </p>
<div class="org-src-container"> <div class="org-src-container">
<pre class="src src-bash">make install <pre class="src src-bash">make install
</pre> </pre>
</div> </div>
@ -285,9 +369,9 @@ Submit your working app to <b><a href="https://github.com/bashrc/freedombone/iss
</div> </div>
</div> </div>
<div id="outline-container-sec-4" class="outline-2"> <div id="outline-container-org2b37622" class="outline-2">
<h2 id="sec-4">Customising mesh images</h2> <h2 id="org2b37622">Customising mesh images</h2>
<div class="outline-text-2" id="text-4"> <div class="outline-text-2" id="text-org2b37622">
<p> <p>
If you want to make your own specially branded version of the mesh images, such as for a particular event, then to change the default desktop backgrounds edit the images within <b>img/backgrounds</b> and to change the available avatars and desktop icons edit the images within <b>img/avatars</b>. Re-create disk images using the instructions shown previously. If you want to make your own specially branded version of the mesh images, such as for a particular event, then to change the default desktop backgrounds edit the images within <b>img/backgrounds</b> and to change the available avatars and desktop icons edit the images within <b>img/avatars</b>. Re-create disk images using the instructions shown previously.
</p> </p>