elog2labfolder/_build/latex/elog2labfolder.tex
changeset 3 b71be85a294c
child 11 ccfe3c7fa0d2
equal deleted inserted replaced
2:5e51ce17f274 3:b71be85a294c
       
     1 %% Generated by Sphinx.
       
     2 \def\sphinxdocclass{report}
       
     3 \documentclass[letterpaper,10pt,english]{sphinxmanual}
       
     4 \ifdefined\pdfpxdimen
       
     5    \let\sphinxpxdimen\pdfpxdimen\else\newdimen\sphinxpxdimen
       
     6 \fi \sphinxpxdimen=.75bp\relax
       
     7 
       
     8 \usepackage[utf8]{inputenc}
       
     9 \ifdefined\DeclareUnicodeCharacter
       
    10  \ifdefined\DeclareUnicodeCharacterAsOptional
       
    11   \DeclareUnicodeCharacter{"00A0}{\nobreakspace}
       
    12   \DeclareUnicodeCharacter{"2500}{\sphinxunichar{2500}}
       
    13   \DeclareUnicodeCharacter{"2502}{\sphinxunichar{2502}}
       
    14   \DeclareUnicodeCharacter{"2514}{\sphinxunichar{2514}}
       
    15   \DeclareUnicodeCharacter{"251C}{\sphinxunichar{251C}}
       
    16   \DeclareUnicodeCharacter{"2572}{\textbackslash}
       
    17  \else
       
    18   \DeclareUnicodeCharacter{00A0}{\nobreakspace}
       
    19   \DeclareUnicodeCharacter{2500}{\sphinxunichar{2500}}
       
    20   \DeclareUnicodeCharacter{2502}{\sphinxunichar{2502}}
       
    21   \DeclareUnicodeCharacter{2514}{\sphinxunichar{2514}}
       
    22   \DeclareUnicodeCharacter{251C}{\sphinxunichar{251C}}
       
    23   \DeclareUnicodeCharacter{2572}{\textbackslash}
       
    24  \fi
       
    25 \fi
       
    26 \usepackage{cmap}
       
    27 \usepackage[T1]{fontenc}
       
    28 \usepackage{amsmath,amssymb,amstext}
       
    29 \usepackage{babel}
       
    30 \usepackage{times}
       
    31 \usepackage[Bjarne]{fncychap}
       
    32 \usepackage[dontkeepoldnames]{sphinx}
       
    33 
       
    34 \usepackage{geometry}
       
    35 
       
    36 % Include hyperref last.
       
    37 \usepackage{hyperref}
       
    38 % Fix anchor placement for figures with captions.
       
    39 \usepackage{hypcap}% it must be loaded after hyperref.
       
    40 % Set up styles of URL: it should be placed after hyperref.
       
    41 \urlstyle{same}
       
    42 \addto\captionsenglish{\renewcommand{\contentsname}{Contents:}}
       
    43 
       
    44 \addto\captionsenglish{\renewcommand{\figurename}{Fig.}}
       
    45 \addto\captionsenglish{\renewcommand{\tablename}{Table}}
       
    46 \addto\captionsenglish{\renewcommand{\literalblockname}{Listing}}
       
    47 
       
    48 \addto\captionsenglish{\renewcommand{\literalblockcontinuedname}{continued from previous page}}
       
    49 \addto\captionsenglish{\renewcommand{\literalblockcontinuesname}{continues on next page}}
       
    50 
       
    51 \addto\extrasenglish{\def\pageautorefname{page}}
       
    52 
       
    53 \setcounter{tocdepth}{1}
       
    54 
       
    55 
       
    56 
       
    57 \title{Labfolder at FHI Documentation}
       
    58 \date{Jan 11, 2018}
       
    59 \release{1.0}
       
    60 \author{Stefan Weiher}
       
    61 \newcommand{\sphinxlogo}{\vbox{}}
       
    62 \renewcommand{\releasename}{Release}
       
    63 \makeindex
       
    64 
       
    65 \begin{document}
       
    66 
       
    67 \maketitle
       
    68 \sphinxtableofcontents
       
    69 \phantomsection\label{\detokenize{index::doc}}
       
    70 
       
    71 
       
    72 
       
    73 \chapter{Installation of labfolder}
       
    74 \label{\detokenize{installation:welcome-to-elog2labfolder-s-documentation}}\label{\detokenize{installation::doc}}\label{\detokenize{installation:installation-of-labfolder}}
       
    75 Labfolder is easy to install. Follow the instructions given in the \sphinxstyleemphasis{labfolder Installation Manual}. The broad steps are: \sphinxstylestrong{install MySQL, docker and labolder; configure labfolder via the server.cnf file}. This labfolder config file could look like this:
       
    76 
       
    77 \fvset{hllines={, ,}}%
       
    78 \begin{sphinxVerbatim}[commandchars=\\\{\}]
       
    79 \PYGZsh{} Network settings
       
    80 DEFAULT\PYGZus{}HTTP\PYGZus{}PROTOCOL=https://
       
    81 DEFAULT\PYGZus{}DOMAIN=labfolder.rz\PYGZhy{}berlin.mpg.de
       
    82 
       
    83 \PYGZsh{} JDBC Properties
       
    84 JDBC\PYGZus{}SERVER\PYGZus{}TIMEZONE=Europe/Berlin
       
    85 JDBC\PYGZus{}DATABASE\PYGZus{}URL=jdbc:mysql://localhost:3306/labfolder?useUnicode=true\PYGZam{}characterEncoding=UTF\PYGZhy{}8
       
    86 JDBC\PYGZus{}USERNAME=labfolder
       
    87 JDBC\PYGZus{}PASSWORD=fhilab
       
    88 JDBC\PYGZus{}SCHEMA\PYGZus{}NAME=labfolder
       
    89 \PYGZsh{}REMOVE\PYGZus{}ABANDONED\PYGZus{}TIMEOUT=60
       
    90 
       
    91 \PYGZsh{} Mail client properties
       
    92 MAIL\PYGZus{}STARTTLS=false
       
    93 MAIL\PYGZus{}AUTHENTICATION\PYGZus{}ENABLE=false
       
    94 MAIL\PYGZus{}HOST=mail.fhi\PYGZhy{}berlin.mpg.de
       
    95 MAIL\PYGZus{}PORT=25
       
    96 \PYGZsh{}MAIL\PYGZus{}USERNAME=
       
    97 \PYGZsh{}MAIL\PYGZus{}PASSWORD=
       
    98 MAIL\PYGZus{}EMAIL=ppb@fhi\PYGZhy{}berlin.mpg.de
       
    99 
       
   100 \PYGZsh{} Server Event logging
       
   101 LOG\PYGZus{}TO\PYGZus{}FILE=true
       
   102 
       
   103 \PYGZsh{}Maximum upload file size
       
   104 FILEUPLOAD\PYGZus{}MAXUPLOADSIZE=25000000
       
   105 
       
   106 \PYGZsh{} User and group control
       
   107 DEFAULT\PYGZus{}GROUP\PYGZus{}SIZE=50
       
   108 DEFAULT\PYGZus{}GROUP\PYGZus{}TYPE\PYGZus{}MAXI=true
       
   109 DEFAULT\PYGZus{}USER\PYGZus{}STORAGE=3221225472
       
   110 FEATURE\PYGZus{}GLOBAL\PYGZus{}PREVENT\PYGZus{}DELETE\PYGZus{}CONTENT=false
       
   111 
       
   112 \PYGZsh{} Terms and Privacy links
       
   113 TERMS\PYGZus{}OF\PYGZus{}USE\PYGZus{}LINK=https://www.labfolder.com/terms\PYGZhy{}external\PYGZhy{}servers/
       
   114 PRIVACY\PYGZus{}LINK=https://www.labfolder.com/privacy\PYGZhy{}external\PYGZhy{}servers/
       
   115 
       
   116 \PYGZsh{} LDAP Authentication
       
   117 FEATURE\PYGZus{}LDAP\PYGZus{}AUTHENTICATION=true
       
   118 LDAP\PYGZus{}URL=ldap://ldap.rz\PYGZhy{}berlin.mpg.de:389
       
   119 LDAP\PYGZus{}BASE=ou=people,dc=ppb,dc=rz\PYGZhy{}berlin,dc=mpg,dc=de
       
   120 \PYGZsh{}LDAP\PYGZus{}SERVER\PYGZus{}TYPE=
       
   121 LDAP\PYGZus{}USER\PYGZus{}DN=cn=pwCheck,dc=rz\PYGZhy{}berlin,dc=mpg,dc=de
       
   122 LDAP\PYGZus{}PASSWORD=ProstetnikVogonJeltz
       
   123 \PYGZsh{}LDAP\PYGZus{}ANONYMOUS\PYGZus{}READ\PYGZus{}ONLY=
       
   124 LDAP\PYGZus{}USER\PYGZus{}DN\PYGZus{}PATTERNS=uid=\PYGZob{}0\PYGZcb{}
       
   125 \PYGZsh{}LDAP\PYGZus{}IS\PYGZus{}TLS\PYGZus{}ENABLED=
       
   126 \PYGZsh{}LDAP\PYGZus{}IS\PYGZus{}ATTRIBUTE\PYGZus{}SEARCH\PYGZus{}ENABLED=
       
   127 \PYGZsh{}LDAP\PYGZus{}ATTRIBUTE\PYGZus{}SEARCH\PYGZus{}NAME=
       
   128 
       
   129 \PYGZsh{} Usage monitoring
       
   130 ACTIVE\PYGZus{}USER\PYGZus{}REPORT\PYGZus{}USE\PYGZus{}DEFAULT\PYGZus{}MAIL\PYGZus{}CLIENT=true
       
   131 CUSTOMER\PYGZus{}IDENTIFIER=\PYGZsq{}Fritz\PYGZhy{}Haber\PYGZhy{}Institut\PYGZsq{}
       
   132 
       
   133 \PYGZsh{} Mendeley
       
   134 FEATURE\PYGZus{}MENDELEY=false
       
   135 \PYGZsh{}MENDELEY\PYGZus{}CLIENT\PYGZus{}ID=
       
   136 \PYGZsh{}MENDELEY\PYGZus{}CLIENT\PYGZus{}SECRET=
       
   137 \PYGZsh{}MENDELEY\PYGZus{}CLIENT\PYGZus{}CALLBACKURL=http://localhost:9091/eln/mendeley/oauthCallback
       
   138 
       
   139 \PYGZsh{} Dropbox
       
   140 FEATURE\PYGZus{}DROPBOX=false
       
   141 \PYGZsh{}DROPBOX\PYGZus{}CONSUMER\PYGZus{}KEY=
       
   142 \PYGZsh{}DROPBOX\PYGZus{}CONSUMER\PYGZus{}SECRET=
       
   143 
       
   144 \PYGZsh{} Figshare
       
   145 FEATURE\PYGZus{}FIGSHARE=false
       
   146 
       
   147 \PYGZsh{} XHTML Export
       
   148 FEATURE\PYGZus{}XHTML\PYGZus{}EXPORT=true
       
   149 EXPORT\PYGZus{}DOCUMENT\PYGZus{}REPOSITORY\PYGZus{}TYPE=fileSystem
       
   150 \end{sphinxVerbatim}
       
   151 
       
   152 The configuration is explained in detail in the installation manual. Now, \sphinxstylestrong{create the labfolder database and run labfolder} (see the manual for details). Additionally, you could install Apache and set it up as a reverse proxy in order to make labfolder only available through https. The exact steps are:
       
   153 
       
   154 \fvset{hllines={, ,}}%
       
   155 \begin{sphinxVerbatim}[commandchars=\\\{\}]
       
   156 labfolder@lf:\PYGZti{}\PYGZdl{} sudo apt\PYGZhy{}get install build\PYGZhy{}essential
       
   157 labfolder@lf:\PYGZti{}\PYGZdl{} sudo apt install apache2
       
   158 labfolder@lf:\PYGZti{}\PYGZdl{} sudo a2enmod proxy proxy\PYGZus{}ajp proxy\PYGZus{}http rewrite deflate headers proxy\PYGZus{}balancer proxy\PYGZus{}connect proxy\PYGZus{}html xml2enc
       
   159 labfolder@lf:\PYGZti{}\PYGZdl{} sudo a2enmod ssl
       
   160 
       
   161 \PYGZsh{}\PYGZsh{}\PYGZsh{} Use certificates from e.g. let\PYGZsq{}s encrypt. Please see below for more information.
       
   162 
       
   163 \PYGZsh{}\PYGZsh{}\PYGZsh{} create /etc/apache2/sites\PYGZhy{}available/labfolder.conf with virtual hosts for http and https:
       
   164 labfolder@lf:\PYGZti{}\PYGZdl{} sudo a2ensite labfolder.conf
       
   165 labfolder@lf:\PYGZti{}\PYGZdl{} sudo a2dissite 000\PYGZhy{}default.conf
       
   166 labfolder@lf:\PYGZti{}\PYGZdl{} sudo service apache2 restart
       
   167 \end{sphinxVerbatim}
       
   168 
       
   169 To get SSL certificates from letsencrypt is quite straight forward. For example this guide shows how to set up SSL certificates:
       
   170 
       
   171 \sphinxurl{https://www.digitalocean.com/community/tutorials/how-to-secure-apache-with-let-s-encrypt-on-ubuntu-16-04}
       
   172 
       
   173 The Apache labfolder config file could look like this:
       
   174 
       
   175 \fvset{hllines={, ,}}%
       
   176 \begin{sphinxVerbatim}[commandchars=\\\{\}]
       
   177 \PYG{o}{\PYGZlt{}}\PYG{n}{VirtualHost} \PYG{o}{*}\PYG{p}{:}\PYG{l+m+mi}{80}\PYG{o}{\PYGZgt{}}
       
   178     \PYG{n}{ErrorLog} \PYG{o}{/}\PYG{n}{var}\PYG{o}{/}\PYG{n}{log}\PYG{o}{/}\PYG{n}{apache2}\PYG{o}{/}\PYG{n}{error}\PYG{o}{.}\PYG{n}{log}
       
   179     \PYG{n}{LogLevel} \PYG{n}{warn}
       
   180 
       
   181     \PYG{n}{ServerName} \PYG{n}{labfolder}\PYG{o}{.}\PYG{n}{rz}\PYG{o}{\PYGZhy{}}\PYG{n}{berlin}\PYG{o}{.}\PYG{n}{mpg}\PYG{o}{.}\PYG{n}{de}
       
   182     \PYG{n}{Redirect} \PYG{o}{/} \PYG{n}{https}\PYG{p}{:}\PYG{o}{/}\PYG{o}{/}\PYG{n}{labfolder}\PYG{o}{.}\PYG{n}{rz}\PYG{o}{\PYGZhy{}}\PYG{n}{berlin}\PYG{o}{.}\PYG{n}{mpg}\PYG{o}{.}\PYG{n}{de}\PYG{o}{/}
       
   183 \PYG{o}{\PYGZlt{}}\PYG{o}{/}\PYG{n}{VirtualHost}\PYG{o}{\PYGZgt{}}
       
   184 
       
   185 \PYG{o}{\PYGZlt{}}\PYG{n}{VirtualHost} \PYG{o}{*}\PYG{p}{:}\PYG{l+m+mi}{443}\PYG{o}{\PYGZgt{}}
       
   186     \PYG{n}{ErrorLog} \PYG{o}{/}\PYG{n}{var}\PYG{o}{/}\PYG{n}{log}\PYG{o}{/}\PYG{n}{apache2}\PYG{o}{/}\PYG{n}{error}\PYG{o}{.}\PYG{n}{log}
       
   187     \PYG{n}{LogLevel} \PYG{n}{warn}
       
   188 
       
   189     \PYG{n}{ServerName} \PYG{n}{labfolder}\PYG{o}{.}\PYG{n}{rz}\PYG{o}{\PYGZhy{}}\PYG{n}{berlin}\PYG{o}{.}\PYG{n}{mpg}\PYG{o}{.}\PYG{n}{de}
       
   190 
       
   191     \PYG{n}{SSLEngine} \PYG{n}{On}
       
   192     \PYG{n}{SSLCertificateFile} \PYG{o}{/}\PYG{n}{etc}\PYG{o}{/}\PYG{n}{letsencrypt}\PYG{o}{/}\PYG{n}{live}\PYG{o}{/}\PYG{n}{labfolder}\PYG{o}{.}\PYG{n}{rz}\PYG{o}{\PYGZhy{}}\PYG{n}{berlin}\PYG{o}{.}\PYG{n}{mpg}\PYG{o}{.}\PYG{n}{de}\PYG{o}{/}\PYG{n}{fullchain}\PYG{o}{.}\PYG{n}{pem}
       
   193     \PYG{n}{SSLCertificateKeyFile} \PYG{o}{/}\PYG{n}{etc}\PYG{o}{/}\PYG{n}{letsencrypt}\PYG{o}{/}\PYG{n}{live}\PYG{o}{/}\PYG{n}{labfolder}\PYG{o}{.}\PYG{n}{rz}\PYG{o}{\PYGZhy{}}\PYG{n}{berlin}\PYG{o}{.}\PYG{n}{mpg}\PYG{o}{.}\PYG{n}{de}\PYG{o}{/}\PYG{n}{privkey}\PYG{o}{.}\PYG{n}{pem}
       
   194 
       
   195     \PYG{n}{ProxyPass} \PYG{o}{/} \PYG{n}{http}\PYG{p}{:}\PYG{o}{/}\PYG{o}{/}\PYG{l+m+mf}{141.14}\PYG{o}{.}\PYG{l+m+mf}{138.230}\PYG{p}{:}\PYG{l+m+mi}{9091}\PYG{o}{/}
       
   196     \PYG{n}{ProxyPassReverse} \PYG{o}{/} \PYG{n}{http}\PYG{p}{:}\PYG{o}{/}\PYG{o}{/}\PYG{l+m+mf}{141.14}\PYG{o}{.}\PYG{l+m+mf}{138.230}\PYG{p}{:}\PYG{l+m+mi}{9091}\PYG{o}{/}
       
   197 \PYG{o}{\PYGZlt{}}\PYG{o}{/}\PYG{n}{VirtualHost}\PYG{o}{\PYGZgt{}}
       
   198 \end{sphinxVerbatim}
       
   199 
       
   200 
       
   201 \chapter{Groups, ownership and sharing in labfolder}
       
   202 \label{\detokenize{groups:groups-ownership-and-sharing-in-labfolder}}\label{\detokenize{groups::doc}}
       
   203 As labfolder user you can create groups (ultimately: group projects) and private projects. In \sphinxstyleemphasis{Manage \textgreater{} Projects} you see all projects that you own and that you are a member of.
       
   204 
       
   205 
       
   206 \section{Private projects}
       
   207 \label{\detokenize{groups:private-projects}}
       
   208 You alone are the owner of these projects in \sphinxstyleemphasis{My Private Projects}. Their ownership cannot be transfered from you to anyone else via the webinterface. Only via directly manipulating the database the ownership can be changed to an active user.
       
   209 
       
   210 \noindent{\hspace*{\fill}\sphinxincludegraphics[width=0.700\linewidth]{{private_projects}.png}\hspace*{\fill}}
       
   211 
       
   212 
       
   213 \section{Group projects}
       
   214 \label{\detokenize{groups:group-projects}}
       
   215 Any labfolder user can create groups and subgroups in \sphinxstyleemphasis{Manage \textgreater{} Groups \textgreater{} Button “+Add”}. Within (sub)groups you can create group projects of which you are the administrator (admin). In the role of the admin you can do the following:
       
   216 \begin{itemize}
       
   217 \item {} 
       
   218 invite users to your (sub)group via e-mail
       
   219 
       
   220 \item {} 
       
   221 move users between subgroups
       
   222 
       
   223 \item {} 
       
   224 set and remove (sub)group members as admins
       
   225 
       
   226 \item {} 
       
   227 remove users from a (sub)group e.g. when they are leaving the institute (\sphinxstylestrong{In this case the ownership of this user’s projects within the (sub)group needs to be transfered first!})
       
   228 
       
   229 \item {} 
       
   230 delete (sub)groups (before deleting it you need to remove all group members)
       
   231 
       
   232 \end{itemize}
       
   233 
       
   234 
       
   235 \section{Group settings}
       
   236 \label{\detokenize{groups:group-settings}}
       
   237 Administrators of groups (but not the ones of the subgroups) can edit the general settings of groups.
       
   238 
       
   239 \noindent{\hspace*{\fill}\sphinxincludegraphics[width=0.700\linewidth]{{group_settings}.png}\hspace*{\fill}}
       
   240 \begin{itemize}
       
   241 \item {} 
       
   242 Through the option \sphinxstyleemphasis{Prevent group members from deleting content} all users (including the admin) are prevented from deleting projects or any other data from the labfolder database. Projects will merely be hidden if a user decides to \sphinxstyleemphasis{Remove} it from their list of projects.
       
   243 
       
   244 \item {} 
       
   245 By checking the option \sphinxstyleemphasis{Prevent group members from having private projects}, group members will not be allowed to have private projects. All private projects of group members will be moved into the group projects, but will not be shared with any other group members.
       
   246 
       
   247 \item {} 
       
   248 By switching on \sphinxstyleemphasis{Users can be members of several subgroups}, users which are already members of a group can be invited again to another subgroup within the group. If switched to off members cannot be invited to subgroups of their current group.
       
   249 
       
   250 \end{itemize}
       
   251 
       
   252 
       
   253 \chapter{Import and export of projects and entries}
       
   254 \label{\detokenize{import_export::doc}}\label{\detokenize{import_export:import-and-export-of-projects-and-entries}}
       
   255 
       
   256 \section{Import}
       
   257 \label{\detokenize{import_export:import}}
       
   258 The import of projects (from another labfolder instance or from another logbook software) is only possible via the labfolder API. An import of labfolder-own projects via webinterface is not possible to date. You can find the API documentation here:
       
   259 
       
   260 \begin{DUlineblock}{0em}
       
   261 \item[] Version 1: \sphinxurl{http://labfolder.rz-berlin.mpg.de:9091/api/v1}
       
   262 \item[] Version 2: \sphinxurl{https://labfolder.rz-berlin.mpg.de/api/v2/docs/development.html}
       
   263 \end{DUlineblock}
       
   264 
       
   265 Version 2 is still in the development phase.
       
   266 
       
   267 
       
   268 \section{Export}
       
   269 \label{\detokenize{import_export:export}}
       
   270 Exporting projects (or just single entries) is possible in three different formats: PDF, XHTML and JSON. The export as PDF can be done from within a project …
       
   271 
       
   272 \noindent{\hspace*{\fill}\sphinxincludegraphics[width=0.700\linewidth]{{export_of_projects}.png}\hspace*{\fill}}
       
   273 
       
   274 … or from the project overview (\sphinxstyleemphasis{Manage \textgreater{} Projects}):
       
   275 
       
   276 \noindent{\hspace*{\fill}\sphinxincludegraphics[width=0.700\linewidth]{{export_of_projects2}.png}\hspace*{\fill}}
       
   277 
       
   278 The XHTML export can be done via the settings:
       
   279 
       
   280 \noindent{\hspace*{\fill}\sphinxincludegraphics[width=0.700\linewidth]{{export_xhtml}.png}\hspace*{\fill}}
       
   281 
       
   282 However, to use this type of export it has to be installed first in the \sphinxstyleemphasis{Manage \textgreater{} Apps} section. By means of the XHTML export all projects that one owns will be exported. A detailled selection of projects or entries to be exported is not possible. As soon as the export process is finished a download link appears in the settings in \sphinxstyleemphasis{Data exports}. The downloadable ZIP file contains all images and files along with an index.html file that contains information about all entries. You could open and view the index.html file in a browser similar to the view in labfolder.
       
   283 
       
   284 The JSON export is only useable via the API endpoint \sphinxcode{GET /entries}. However, at the moment the response only contains useful information such as dates and tags. The author name is hidden behind the author ID and the entry text content is completely missing.
       
   285 
       
   286 
       
   287 \chapter{Importing projects from e.g. the ELOGbook to Labfolder at the FHI}
       
   288 \label{\detokenize{importing_from_elog:importing-projects-from-e-g-the-elogbook-to-labfolder-at-the-fhi}}\label{\detokenize{importing_from_elog::doc}}
       
   289 The ELOG entries of a certain project need to be exported as \sphinxstyleemphasis{Raw} which looks like this:
       
   290 
       
   291 \fvset{hllines={, ,}}%
       
   292 \begin{sphinxVerbatim}[commandchars=\\\{\}]
       
   293 \PYGZdl{}@MID@\PYGZdl{}: 12
       
   294 Date: Tue, 03 Dec 2013 12:15:14 +0100
       
   295 Author: Wieland SchÃ\P{}llkopf
       
   296 Author Email: mailto:wschoell@fhi\PYGZhy{}berlin.mpg.de
       
   297 Category: Shift summary
       
   298 Subject: 1st solid\PYGZhy{}state experiment with FHI FEL
       
   299 Severity: DOCU
       
   300 Keywords:
       
   301 Record date: 1386069171
       
   302 Attachment:
       
   303 Encoding: HTML
       
   304 ========================================
       
   305 \PYGZlt{}p\PYGZgt{}Today Alex Paarmann and Marc Herzog are measuring in the wavelength range from 10 to 20 micron with a 0.5 mm thick GGG (Gadolinium Gallium Garnet, \PYGZlt{}a title=\PYGZdq{}Gadolinium\PYGZdq{} href=\PYGZdq{}http://en.wikipedia.org/wiki/Gadolinium\PYGZdq{}\PYGZgt{}Gd\PYGZlt{}/a\PYGZgt{}\PYGZlt{}sub\PYGZgt{}3\PYGZlt{}/sub\PYGZgt{}\PYGZlt{}a title=\PYGZdq{}Gallium\PYGZdq{} href=\PYGZdq{}http://en.wikipedia.org/wiki/Gallium\PYGZdq{}\PYGZgt{}Ga\PYGZlt{}/a\PYGZgt{}\PYGZlt{}sub\PYGZgt{}5\PYGZlt{}/sub\PYGZgt{}\PYGZlt{}a title=\PYGZdq{}Oxygen\PYGZdq{} href=\PYGZdq{}http://en.wikipedia.org/wiki/Oxygen\PYGZdq{}\PYGZgt{}O\PYGZlt{}/a\PYGZgt{}\PYGZlt{}sub\PYGZgt{}12\PYGZlt{}/sub\PYGZgt{}). Electron energy is set to 26 MeV.\PYGZlt{}/p\PYGZgt{}
       
   306 \end{sphinxVerbatim}
       
   307 
       
   308 This ASCII export looks like this in the ELOG webinterface:
       
   309 
       
   310 \noindent{\hspace*{\fill}\sphinxincludegraphics[width=1.000\linewidth]{{elog_entry}.png}\hspace*{\fill}}
       
   311 
       
   312 What is noticeable is that the ELOG export comes with a “Ã\P{}” instead of an “ö”. Interestingly, if only entries done by Wieland are exported the export file has UTF-8 encoding which can actually print German “Umlaute” (ö, ä, ü). If all entries are exported the encoding changes to an encoding that cannot handle e.g. “ö”.
       
   313 
       
   314 After importing the above ELOG entry into labfolder this entry appears like that:
       
   315 
       
   316 \noindent{\hspace*{\fill}\sphinxincludegraphics[width=1.000\linewidth]{{entry_after_import}.png}\hspace*{\fill}}
       
   317 
       
   318 
       
   319 
       
   320 \renewcommand{\indexname}{Index}
       
   321 \printindex
       
   322 \end{document}