aboutsummaryrefslogtreecommitdiff
path: root/news/2018-08.inc
diff options
context:
space:
mode:
Diffstat (limited to 'news/2018-08.inc')
-rw-r--r--news/2018-08.inc53
1 files changed, 53 insertions, 0 deletions
diff --git a/news/2018-08.inc b/news/2018-08.inc
new file mode 100644
index 00000000..b29618b9
--- /dev/null
+++ b/news/2018-08.inc
@@ -0,0 +1,53 @@
1<h3>
22018-08: GSoC 2018 - GNUnet Web-based User Interface
3</h3>
4<p>
5Tue, 08/14/2018 - 07:55 - Phil Buschmann
6</p>
7<h4>What was done?</h4>
8<p>
9In the context of Google Summer of Code 2018, my mentor (Martin Schanzenbach) and I have worked on creating and extending the REST API of GNUnet. Currently, we mirrored the functionality of following commands:
10<ul>
11<li>gnunet-identity
12<li>gnunet-namestore
13<li>gnunet-gns
14<li>gnunet-peerinfo
15</ul>
16</p>
17<p>
18Additionally, we developed a website with the Javascript framework Angular 6 and the design framework iotaCSS to use the new REST API. The REST API of GNUnet is now documented with Sphinx.
19</p>
20
21<h4>Why did we create a REST API?</h4>
22<p>
23... when you can use the command line tools?
24We need to keep in mind, that everyone has the right to stay secure and private but not everyone feels comfortable using a terminal. The further developed REST access to GNUnet APIs in addition to the new web application allows new users to interact with GNUnet over a well known tool: their browsers. This addition to the C API and the command line tools may attract new users and developers.
25</p>
26
27<h4>How can we use it?</h4>
28<ol>
29<li>The REST API developed in GNUnet
30The REST API is already merged into the gnunet.git repository (GNUnet Main Git).
31To use the new features, clone the repository and follow the Installation on gnunet.org. Then, start the rest service with "gnunet-arm -i rest".
32
33<li>The Web Application
34The web application is available under the gnunet-webui.git repository (GNUnet WebUI Git).
35You need to install the newest version of 'node' and 'yarn'. Dependent on your system, you may need to download newer versions and install them manually and not over your packet manager. After the installation succeeded, you need to clone the repository. Then, you need to run "yarn install" and "yarn start" for testing purposes. To deploy the website (keep in mind, that this website communicates with another localhost instance) use "yarn build" for building the web application and use the output in the 'dist' directory.
36
37<li>The Documentation
38The documentation is available under the gnunet-rest-api.git repository (GNUnet REST API Docmentation Git).
39Clone the repository and "make html". Then open the 'index.html' under 'build/html/'.
40</ol>
41<p>
42Please, give it a try and contact me, if you find any bugs or unintentional features. ;)
43</p>
44
45<h4>What can be improved?</h4>
46<p>
47Right now, the build process of the web application may be a little too complex for a casual user. We may be able to solve this by using docker.
48Additionally, the web application does not prevent wrong inputs but responds with error messages. Adding GNUnet Records is currently only usable for people, who know how a GNS Record looks like. This can be adapted to each record type.
49Last but not least, additional features, design changes, etc...
50</p>
51<p>
52Thanks for reading.
53</p>