<?xml version="1.0" encoding="UTF-8" ?>
<?xml-stylesheet type="text/xsl" href="adx2html_phonelist.xsl" ?>
<!-- See https://adx.elektronengehirn.net for details -->
<addressbook id="adx - addressbook.xml">

<settings>
  <setting name="contacts_sorting">NO</setting><!-- YES/NO: If NO, then sorting of entries (contacts) is disalbed and shown in same order as in xml file (but still grouped by adx:frequency) -->
  <setting name="menu_show">NO</setting><!--  NO: hide top menu -->
  <setting name="grouping_show_default">medium</setting><!-- medium: show contacts with tag "adx:frequency=medium" (default value is 'medium' if contact doesn't have it assigned at all) -->
  <!--setting name="debug">YES</setting-->
  <setting name="experimental__formatting_misc_enabled">YES</setting><!-- YES/NO: If YES, HTML tags in tag "misc" are preserved (e.g. to format the text) -->
  <!--setting name="experimental__custom_css">.formattedtag a { color:#364e59 !important }</setting-->
  <setting name="experimental__custom_css">
    .formattedtag a       { text-decoration-line: underline;
                            text-decoration-color: darksalmon;
                            text-decoration-thickness: 0.25em;
                            border: none; }
    .formattedtag a:hover { color: #cc7253; }
    .myHighlight          { background-color: yellow; }
    .myBorders            { border: 2px dotted; }
  </setting>
</settings>


<contact id="">
  <displayname>What is adx</displayname>
  <misc format="xhtml" access="quick">Minimalistic but full-featured and web enabled address book<br/>
running completely in your web browser. Data privacy in mind.<br/>
No further dependencies. See <a href="https://elektronengehirn.net/addressbook/addressbook.xml" target="new">Live demo</a> or <a href="https://sourceforge.net/projects/adx/files/latest/download">download</a>.</misc>
</contact>

<contact>
  <displayname>What you need</displayname>
  <misc format="xhtml" access="quick">A web browser (e.g. Firefox, Chrome, Chromium, Safari, Vivaldi, Opera, Brave, Edge, etc).
  <!--
  <br/>For usage from local disc you need to <a href="#browsercfg">configure your browser</a> to allow local access
  -->
  </misc>
  <misc>IE is not tested any more and therefore not supported.</misc>
</contact>

<contact>
  <displayname>Operating System</displayname>
  <misc format="xhtml" access="quick">Any OS (including Linux, Windows, Mac OS, Android, etc.)<br/>
  The OS doesn't matter, just a web browser is needed.
  </misc>
</contact>

<contact>
<displayname>Features</displayname>
<misc format="xhtml" access="quick">
Contact management incl. web accounts<br/>
Usage as personal address book or shared contact list<br/>
Very small size (ca. 350 KByte)<br/>
Lightweight (only 2 XML files, no dependencies)<br/>
Address book in Plain Old XML (POX) for self editing<br/>
Optimized for Desktop Screens (but still usable on smaller screens like mobile phones)<br/>
Online hosting (e.g. easy self-hosting on any web server/space)<br/>
Local hosting (e.g. on local disk) possible but needs a browser config change<br/>
Cookie-free solution<br/>
Complete offline usage possible<br/>
Portable (e.g. on USB flash drive)<br/>
Search in contacts<br/>
Birthday/anniversary reminder<br/>
Tagging of contacts<br/>
Geo mapping by address, longitude/latitude or <abbr title="geocode system with 3 words">what3words</abbr><br/>
Supports a11y (accessibility) based on WAI-RIA W3C recommendation<br/>
Semantic data support: Microformats <a href="https://microformats.org/wiki/hcard"><abbr title="HTML vCard">hCard</abbr> 1.0</a> and <a href="https://gmpg.org/xfn/"><abbr title="XHTML Friends Network">XFN</abbr></a><br/>
<!--a href="https://adx.elektronengehirn.net/import/hcard2adx.php">Importer</a> (hCard Microformats) - currently down<br-->
<!--a href="https://adx.elektronengehirn.net/importoc/">Importer Open Contacts</a><br-->
Configurable (URL parameter, in XML or XSLT file)<br/>
Customizable (XSLT)<br/>
Export as vCard via file or QR code (completely offline)<br/>
QR Code generation of any kind (completely offline)
</misc>
</contact>

<contact id="HotFeatures">
  <displayname>Hot features</displayname>
  <!-- 
  To enable the formatting within ths span tags below you need to set following setting in <settings> section at the beginning of this file:
  <setting name="experimental__formatting_misc_enabled">YES</setting>
  -->
  <misc access="quick">New/experimental features in adx v1.50/1.52</misc>
  <misc format="xhtml" access="quick">1. <span class="secondary">[final since v1.50]</span> Custom settings in addressbook.xml under <span class="primary">&lt;settings></span> tag</misc>
  <misc format="xhtml" access="quick">2. <span class="secondary">[experimental]</span> Quick Access allows putting contact fields on right side e.g. &lt;misc <span class="primary">access="quick"</span>></misc>
  <misc format="xhtml" access="quick">3. <span class="secondary">[experimental]</span> Support (X)HTML tags inside <span class="primary">&lt;misc format="xhtml"></span></misc>
  <misc format="xhtml" access="quick">4. <span class="secondary">[experimental]</span> Support custom CSS formatting</misc>
  <misc format="xhtml" access="quick">See <a href="https://elektronengehirn.net/addressbook/hotfeatures.xml">Live Demo and documentation of hot features</a>.</misc> 
  <misc format="xhtml" access="quick">By combining several experimental features adx can also be used as Micro Content Management System (µCMS).<br/> Actually, THIS website is also using these new features. 
    <span id="adxHTMLized">It was just HTMLized for better <abbr title="Search Engine Optimization">SEO</abbr>. See original <a href="https://elektronengehirn.net/addressbook/index.xml">index.xml</a></span>
    <script>try { if (document.URL.split('#')[0].split('?')[0].split('/').pop().split('.').pop()=='xml') { setElVisibilityById('adxHTMLized',false); } } catch(err) {} </script></misc> 
</contact>

<contact>
<displayname>Supported online accounts</displayname>
<misc format="xhtml" access="quick">Matrix, Skype, TikTok, Twitter, Facebook, Google, digg, tumblr, pinterest,<br/>
  YouTube, Vimeo, imdb, trakt, last.fm, Hype Machine, AllMusic, bandcamp,<br/>
  diaspora, GNU Social, HubZilla, stackexchange sites, LinkedIn, Xing, vkontakte<br/>
  Flickr, DeviantArt, GitHub, SourceForge, and others.<br/>
  Also generic accounts are supported. See all at <a href="https://sourceforge.net/p/adx/wiki/Accounts/">Accounts in adx wiki</a> 
</misc>
</contact>

<!--contact>
  <displayname>Semantic data</displayname>
  <misc format="xhtml" access="quick">Microformats (<a href="https://microformats.org/wiki/hcard"><abbr title="HTML vCard">hCard</abbr> 1.0</a>, <a href="https://gmpg.org/xfn/"><abbr title="XHTML Friends Network">XFN</abbr></a>)</misc>
</contact-->
<contact>
  <displayname>How it works (usage)</displayname>
  <misc format="xhtml" access="quick">Open addressbook.xml in your web browser and<br/>
		you get an address book with many features
	</misc>
</contact>

<contact>
  <displayname>How it works (technically)</displayname>
  <misc format="xhtml" access="quick">
  XML --[XSLT]--> HTML<br/>
  address book (XML file) is tranformed (XSLT file) by web browser to a web app (HTML)</misc>
</contact>

<contact>
  <displayname>Online hosting</displayname>
  <misc format="xhtml" access="quick">
  Yes, also easy self-hosting possible. Just upload the 2 adx files (xml, xsl) on any web server.  
  </misc>
</contact>

<contact>
  <displayname>Local hosting</displayname>
  <misc format="xhtml" access="quick">
  <a name="browsercfg"></a>
  Yes. E.g. drag and drop the file addressbook.xml from your local disk on your browser.<br/>
  BUT due to increased security restrictions by browser vendors you probably need to <a href="https://sourceforge.net/p/adx/wiki/Home/#important-browser-workaround-needed-for-local-usage">configure your browser for accessing local files</a>
  <!--
  Chromium based browsers like Google Chrome, Opera, Vivaldi, Brave work by default only online
  (<a href="https://bugs.chromium.org/p/chromium/issues/detail?id=47416">but not locally</a>).
  <br/>
  Reason: Chromium's more <a href="https://blog.chromium.org/2008/12/security-in-depth-local-web-pages.html">restrictive security model</a>.
  <br/>
  -->
  <!--
  Workaround: Start this browser with cmd line param "<a href="https://sourceforge.net/p/adx/wiki/Home/#workaround-for-chromium-based-browsers-for-local-usage">- -allow-file-access-from-files</a>"
  -->
  <!--
  <br/>
  <br/>
  IE: Changing a security option to allow active content may be needed to run adx.
  -->
  </misc>
</contact>

<contact>
  <displayname>What you should know</displayname>
  <misc format="xhtml" access="quick">adx provides <u>no</u> editor for contacts.<br/>
  Contacts are stored in addressbook.xml (text file)
  which needs to be edited in an external tool.<br/>
  A simple text editor works, even Notepad.
  </misc>
</contact>

<contact>
  <displayname>Live Demo</displayname>
  <misc format="xhtml" access="quick"><a href="https://elektronengehirn.net/addressbook/addressbook.xml" target="new">https://elektronengehirn.net/addressbook/addressbook.xml</a></misc>
</contact>

<contact>
  <displayname>Download</displayname>
  <misc format="xhtml" access="quick">Latest <a href="https://sourceforge.net/projects/adx/files/latest/download" target="_blank">adx_addressbook.xml_vX.XX.zip</a></misc>
</contact>
<contact>
  <displayname>Quick start (online)</displayname>
  <misc format="xhtml" access="quick"><a href="https://sourceforge.net/projects/adx/files/latest/download" target="_blank">Download adx</a>, unzip, upload to your web server and<br/>
    open addressbook.xml in your browser: http(s)://.../addressbook.xml</misc>
</contact>
<contact>
  <displayname>Quick start (local disk)</displayname>
  <misc format="xhtml" access="quick"><a href="https://sourceforge.net/projects/adx/files/latest/download" target="_blank">Download adx</a>, 
    unzip, 
    apply <a href="https://sourceforge.net/p/adx/wiki/Home/#important-browser-workaround-needed-for-local-usage">browser workaround to have access to local files</a> 
    and<br/>
    open addressbook.xml in your browser from local disk: file://.../addressbook.xml<br/>
    Note: If you get just a blank page you need to <a href="https://sourceforge.net/p/adx/wiki/Home/#important-browser-workaround-needed-for-local-usage">configure your browser for accessing local files</a>.
    </misc>
</contact>
<contact>
  <displayname>Supported browsers</displayname>
  <misc format="xhtml" access="quick">Basically all modern web browsers are supported on any OS.<br/>
  Only for using adx from local disk you need to <a href="https://sourceforge.net/p/adx/wiki/Home/#important-browser-workaround-needed-for-local-usage">configure your browser for accessing local files</a>. This can be achieved most conveniently and sustainably with Firefox.<br/>
  Minimum browser versions:<br/>
  Firefox 3+, Chromium based browsers (Chrome, Chromium, Vivaldi, Brave, Opera15+, newer Edge), Safari 3+, Opera 9-12, <span title="latest/mainly tested version was IE 11">IE</span>, superseded Edge.
  <br/>
  While browsers mentioned above were tested at least once, for latest adx release only following <br/>browsers were actively tested (under Ubuntu): Firefox, Chromium, Vivaldi, Opera.
  <br/>
  If you encounter any issue with a certain browser (version) please let me know.
  </misc>
</contact>
<contact>
  <displayname>Browser requirements</displayname>
  <misc format="xhtml" access="quick">
  JavaScript enabled<br/>
  XML/XSLT support (included in every major browser)<br/>
  For local hosting of adx (e.g. local disk) you probably need to <a href="https://sourceforge.net/p/adx/wiki/Home/#important-browser-workaround-needed-for-local-usage">configure your browser for accessing local files</a>
  </misc>
</contact>
<contact>
  <displayname>Add/edit contacts</displayname>
  <misc format="xhtml" access="quick">Edit addressbook.xml in any text editor</misc>
  <misc format="xhtml" access="quick">See provided examples and templates in addressbook.xml to build yours</misc>
</contact>
<contact>
  <displayname>Import/export contacts</displayname>
  <misc format="xhtml" access="quick">
		<a href="https://elektronengehirn.net/addressbook/importoc/">Online Importer</a> for Open Contacts<br/>
		Export via vCard file or QR code (completely offline)
		<br/>
		For more info see <a href="https://sourceforge.net/p/adx/wiki/Home/#import-contacts">adx wiki</a></misc>
</contact>

<contact>
  <displayname>Website</displayname>
  <misc format="xhtml" access="quick"><a class="url" rel="product" href="https://adx.elektronengehirn.net">https://adx.elektronengehirn.net</a> <br/>
  and <a href="https://sourceforge.net/projects/adx">adx project website at SourceForge</a></misc>
</contact>

<contact>
  <displayname>Documentation</displayname>
  <misc format="xhtml" access="quick">See source of <a href="addressbook.xml">addressbook.xml</a> for contact templates and examples and<br/>
  have a look at <a href="https://sourceforge.net/p/adx/wiki/Home/">adx wiki</a> </misc>
</contact>

<contact>
    <displayname>News</displayname>
    <misc format="xhtml" access="quick">
    <a href="https://sourceforge.net/p/adx/news/">adx news at SourceForge</a>
    <br/>
    </misc>
  </contact>
  

<contact>
  <displayname>Why</displayname>
  <misc format="xhtml" access="quick">
    <p style="width:450px">
      I started adx in the early 2000s because I couldn't find an address book tool suited to my needs (and for Javascript/XML/XSLT finger exercises;-)
      <p/>
      Data privacy: <br/>
      I want to keep private data under my own control, instead of "paying" online platforms with intransparent data protection policy with personal data about myself or my contacts.
      <p/>
      Web <span style="display:none;">2.0</span> features: <br/>
      I want a web enabled address book which can call phone numbers by a simple click (e.g. Skype), supports address finding by web mapping (Google Maps, OpenStreetMap, etc.), supports contact tagging, supports Microformats (hCard 1.0, XFN), manages online accounts, ease exporting by QR codes and so on.
      <p/>
      Lightweight:<br/>
      I want a small portable solution which can be used where a web browser or at least a text file viewer is available. No need for installation, browser plugin, server component or anything like that.  So, adx consists only of two files (XML file for the contacts, XSLT file for transforming to HTML within the web browser).
      <p/>
      Sustainability:<br/>
      For data storing I want an open and easy accessible format which to be future proof. Therefore I used Plain Old XML (POX) with a flat data schema leaning on a well-known standard (vCard).
    </p>
  </misc>
</contact>

<contact>
  <displayname>License</displayname>
  <misc format="xhtml" access="quick">adx is open source (<a rel="license" href="https://www.opensource.org/licenses/bsd-license.php">BSD</a> license)<br/>
  Free for private and commercial usage</misc>
</contact>

<contact>
  <displayname>Credits</displayname>
  <misc format="xhtml" access="quick">
		Thx to dandavis for <a href="http://danml.com/download.html" target="new">download.js</a> v4.1, 2008-2015 (<a href="https://creativecommons.org/licenses/by/4.0/" target="new">CCBY2</a> license)
		<br/>
		Thx to Kazuhiko Arase for <a href="https://github.com/kazuhikoarase/qrcode-generator" target="new">qrcode-generator</a> (MIT license)
		<br/>
		Thx to SourceForge for hosting <a href="https://sourceforge.net/projects/adx">adx project website</a>
		<br/>
		The word "QR Code" is registered trademark of DENSO WAVE INCORPORATED
	</misc>
</contact>


<contact id="contact">
  <displayname>Contact</displayname>
  <misc format="xhtml" access="quick">t<!-- hurz
  -->homas.bartensud<span style="color:white;">-</span><span>ä</span>t<span style="color:#FFFFFE;">-</span>goog<span>lema</span>i<span style="display:none;">
  hurz
  <span class="fn">Thomas Bartensud</span>
  <a class="url" href="https://adx.elektronengehirn.net">adx website</a>
  </span>l.com</misc>
</contact>
</addressbook>
