
\begin{DoxyItemize}
\item guid\+: 102b84a3-\/c41e-\/485c-\/8fe2-\/f12a24b3fbfd
\item author\+: Marvin Mall
\item pub\+Date\+: Thu, 22 Dec 2016 17\+:46\+:19 +0100
\item short\+Desc\+: introduces new Elektra website with snippet sharing
\end{DoxyItemize}


\begin{DoxyEnumerate}
\item Release of new Elektra website with an integrated service for sharing of configuration snippets.
\item The website also supports conversion between different configuration formats.
\item Website structures documentation and news sections in a new way.
\end{DoxyEnumerate}

With Elektra developing into a more and more reliable as well as popular system to manage system configurations, the demand for a better public appearance increases as well. For this reason, we are happy to be able to announce the release of our new \href{https://www.libelektra.org}{\texttt{ website}}!

The new website does not only give us a chance to better present ourselves to the open world, it also enables us to structure our project documentation better. We hope that this will make it easier for our users to get started with Elektra and all of its awesome features!

Besides the documentation, the website does also include a database that can be used to share, search, download and convert configuration snippets in various formats. We hope that this tool helps developers and administrators, but also anyone else to simplify their configuration processes when they have to look for a specific configuration snippet. Btw. with snippet we mean that you can also share parts of configuration files that you find particular useful!

But sharing of snippets does not only help other users, it can help yourself as well because you can search for them easier. You also have access to the snippets in various formats at any time, allowing you to use them across multiple system by mounting them with the \href{https://master.libelektra.org/src/plugins/curlget}{\texttt{ curlget}} resolver!

The website was written by Marvin Mall in the course of his \href{https://www.libelektra.org/ftp/elektra/mall2016rest.pdf}{\texttt{ bachelor thesis}} as part of the front-\/end he developed for his snippet sharing service. His main goals were to create a proper appearance for Elektra, but also to create a platform that promotes his service. We think that this worked out quite well by connecting the website with the service the way it was done.

An important aspect of the new website was to make existing documentation more transparent and structured. A lot of documentation files have been changed to achieve this goal and an equal amount of effort was put into writing a system that decouples the documentation structure on the website from the structure used within the Elektra repository.

The tutorials section was partially reworked to make the first steps together with Elektra easier for our users. Clearly the effort put into the tutorials is worth it. Thanks to Erik Schnetter for the valuable feedback where improvements are needed and Christoph Weber for (re)writing the tutorials!

We should note -- as always in software -- that the structure on the website is not final yet and will definitely develop over time, especially the bindings and libraries sections will get some more attention.

If you are interested in the techniques we use to structure our files, you can have a look at the website-\/frontend readme. The website is already the fourth view of our markdown pages! The others are man pages, doxygen, and github.

Besides the documentation we also wanted a place to properly present ourselves and our news around Elektra. For this reason we created a new home page which shall give an overview of what Elektra is and can do. Additionally to that, we also added a news section to keep you better up-\/to-\/date!

We hope that you enjoy our new appearance as much as we do!

Another important part of the website and also without doubt the part that took most effort to create, is the service that allows for sharing of configuration snippets. It is run by a R\+E\+ST service fully built with the help of \href{http://cppcms.com/}{\texttt{ Cpp\+C\+MS}} on basis of Elektra as data store. All data concerning snippets and user accounts is stored in Elektra’s key database (of course with password being properly hashed).

The service allows you to paste configuration snippets in various (supported) formats and to tag, describe and name them. This in return allows you to search snippets by keywords and to download them -- even in other formats than the format used for uploading.

Clearly the service is meant to be driven by its users. Therefore we ask you to share your own configuration snippets, maybe they can be of help, e.\+g., be a time saver for someone else!

Snippets shared with the service are \href{https://www.libelektra.org/devgettingstarted/license}{\texttt{ B\+SD licensed}}. The snippets can also be downloaded directly as bundle from a separate \href{https://github.com/ElektraInitiative/snippets}{\texttt{ Git\+Hub repository}}. As soon as a snippet is added, changed or deleted on the website, a job that updates the repository is triggered. So you can expect the repository to be always up-\/to-\/date.

The website is fully written with the help of Angular\+JS and is therefore heavily based on Java\+Script. This should be no issue though as the website does only use resources that can be found in the official Elektra repository\+:


\begin{DoxyEnumerate}
\item So in case you cannot or do not want to use Java\+Script, you can find all resources also \href{https://git.libelektra.org}{\texttt{ here}}.
\item If you are only worried about executed untrusted Java\+Script, you can study and improve the Web Frontend, which builds the website. Based on this, we hope you disable {\ttfamily No\+Script} for our page so that you are able to share snippets!
\end{DoxyEnumerate}

All Elektra Domains directly hosted by us are now only served by {\ttfamily https}. The former {\ttfamily http} sites are only redirects to {\ttfamily https}. This might cause trouble with some software, e.\+g., update {\ttfamily /etc/apt/sources.list}\+:


\begin{DoxyCode}{0}
\DoxyCodeLine{deb     [trusted=yes] https://build.libelektra.org/debian/ wheezy main}
\DoxyCodeLine{deb-src [trusted=yes] https://build.libelektra.org/debian/ wheezy main}
\end{DoxyCode}


The build Server is no longer reachable at port 8080, but now only directly at \href{https://build.libelektra.org/}{\texttt{ https\+://build.\+libelektra.\+org/}}.

While most {\ttfamily libelektra.\+org} now point to the new website, you can still directly go to \href{https://git.libelektra.org}{\texttt{ github}} and also to the \href{https://bugs.libelektra.org}{\texttt{ bug tracker}}.

The old Wordpress installation was shut down because of security concerns.

At this point there is not much more to say about the new website except for\+: Feel free to explore it!

We greatly appreciate all feedback, be it for the website, the snippet sharing service or other parts of the Elektra project. We always have an open ear for suggestions and we also like to help with technical issues, simply \href{https://bugs.libelektra.org}{\texttt{ leave us a note on github}}!

Subscribe to the reimplemented \href{https://www.libelektra.org/news/feed.rss}{\texttt{ R\+SS feed}} to always get the release notifications.

For any questions and comments, please contact the \href{https://lists.sourceforge.net/lists/listinfo/registry-list}{\texttt{ mailing list}}, use the issue tracker \href{https://bugs.libelektra.org}{\texttt{ on github}} or write an email to \href{mailto:elektra@markus-raab.org}{\texttt{ elektra@markus-\/raab.\+org}}. For issues or feedback concerning the website, you can also contact us at \href{mailto:website@libelektra.org}{\texttt{ website@libelektra.\+org}}.

\href{https://www.libelektra.org/news/website-release}{\texttt{ Permalink to this N\+E\+WS entry}}

For more information, see \href{https://libelektra.org}{\texttt{ https\+://libelektra.\+org}}

Best regards, Marvin \& Markus 