index.html 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359
  1. <!DOCTYPE html>
  2. <!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
  3. <!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
  4. <head>
  5. <meta charset="utf-8">
  6. <meta http-equiv="X-UA-Compatible" content="IE=edge">
  7. <meta name="viewport" content="width=device-width, initial-scale=1.0">
  8. <link rel="shortcut icon" href="../img/favicon.ico">
  9. <title>Directory structure - Shaarli Documentation</title>
  10. <link href='https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'>
  11. <link rel="stylesheet" href="../css/theme.css" type="text/css" />
  12. <link rel="stylesheet" href="../css/theme_extra.css" type="text/css" />
  13. <link rel="stylesheet" href="../css/highlight.css">
  14. <link href="../github-markdown.css" rel="stylesheet">
  15. <script>
  16. // Current page data
  17. var mkdocs_page_name = "Directory structure";
  18. var mkdocs_page_input_path = "Directory-structure.md";
  19. var mkdocs_page_url = "/Directory-structure/";
  20. </script>
  21. <script src="../js/jquery-2.1.1.min.js"></script>
  22. <script src="../js/modernizr-2.8.3.min.js"></script>
  23. <script type="text/javascript" src="../js/highlight.pack.js"></script>
  24. </head>
  25. <body class="wy-body-for-nav" role="document">
  26. <div class="wy-grid-for-nav">
  27. <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
  28. <div class="wy-side-nav-search">
  29. <a href=".." class="icon icon-home"> Shaarli Documentation</a>
  30. <div role="search">
  31. <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
  32. <input type="text" name="q" placeholder="Search docs" />
  33. </form>
  34. </div>
  35. </div>
  36. <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
  37. <ul class="current">
  38. <li class="toctree-l1">
  39. <a class="" href="..">Home</a>
  40. </li>
  41. <li class="toctree-l1">
  42. <span class="caption-text">Setup</span>
  43. <ul class="subnav">
  44. <li class="">
  45. <a class="" href="../Download-and-Installation/">Download and Installation</a>
  46. </li>
  47. <li class="">
  48. <a class="" href="../Upgrade-and-migration/">Upgrade and migration</a>
  49. </li>
  50. <li class="">
  51. <a class="" href="../Server-requirements/">Server requirements</a>
  52. </li>
  53. <li class="">
  54. <a class="" href="../Server-configuration/">Server configuration</a>
  55. </li>
  56. <li class="">
  57. <a class="" href="../Server-security/">Server security</a>
  58. </li>
  59. <li class="">
  60. <a class="" href="../Shaarli-configuration/">Shaarli configuration</a>
  61. </li>
  62. <li class="">
  63. <a class="" href="../Plugins/">Plugins</a>
  64. </li>
  65. </ul>
  66. </li>
  67. <li class="toctree-l1">
  68. <span class="caption-text">Docker</span>
  69. <ul class="subnav">
  70. <li class="">
  71. <a class="" href="../docker/docker-101/">Docker 101</a>
  72. </li>
  73. <li class="">
  74. <a class="" href="../docker/shaarli-images/">Shaarli images</a>
  75. </li>
  76. <li class="">
  77. <a class="" href="../docker/reverse-proxy-configuration/">Reverse proxy configuration</a>
  78. </li>
  79. <li class="">
  80. <a class="" href="../docker/resources/">Docker resources</a>
  81. </li>
  82. </ul>
  83. </li>
  84. <li class="toctree-l1">
  85. <span class="caption-text">Usage</span>
  86. <ul class="subnav">
  87. <li class="">
  88. <a class="" href="../Features/">Features</a>
  89. </li>
  90. <li class="">
  91. <a class="" href="../Bookmarklet/">Bookmarklet</a>
  92. </li>
  93. <li class="">
  94. <a class="" href="../Browsing-and-searching/">Browsing and searching</a>
  95. </li>
  96. <li class="">
  97. <a class="" href="../Firefox-share/">Firefox share</a>
  98. </li>
  99. <li class="">
  100. <a class="" href="../RSS-feeds/">RSS feeds</a>
  101. </li>
  102. <li class="">
  103. <a class="" href="../REST-API/">REST API</a>
  104. </li>
  105. </ul>
  106. </li>
  107. <li class="toctree-l1">
  108. <span class="caption-text">How To</span>
  109. <ul class="subnav">
  110. <li class="">
  111. <a class="" href="../Backup,-restore,-import-and-export/">Backup, restore, import and export</a>
  112. </li>
  113. <li class="">
  114. <a class="" href="../Various-hacks/">Various hacks</a>
  115. </li>
  116. </ul>
  117. </li>
  118. <li class="toctree-l1">
  119. <a class="" href="../Troubleshooting/">Troubleshooting</a>
  120. </li>
  121. <li class="toctree-l1">
  122. <span class="caption-text">Development</span>
  123. <ul class="subnav">
  124. <li class="">
  125. <a class="" href="../Development-guidelines/">Development guidelines</a>
  126. </li>
  127. <li class="">
  128. <a class="" href="../Continuous-integration-tools/">Continuous integration tools</a>
  129. </li>
  130. <li class="">
  131. <a class="" href="../GnuPG-signature/">GnuPG signature</a>
  132. </li>
  133. <li class="">
  134. <a class="" href="../Coding-guidelines/">Coding guidelines</a>
  135. </li>
  136. <li class=" current">
  137. <a class="current" href="./">Directory structure</a>
  138. <ul class="subnav">
  139. </ul>
  140. </li>
  141. <li class="">
  142. <a class="" href="../3rd-party-libraries/">3rd party libraries</a>
  143. </li>
  144. <li class="">
  145. <a class="" href="../Plugin-System/">Plugin System</a>
  146. </li>
  147. <li class="">
  148. <a class="" href="../Release-Shaarli/">Release Shaarli</a>
  149. </li>
  150. <li class="">
  151. <a class="" href="../Versioning-and-Branches/">Versioning and Branches</a>
  152. </li>
  153. <li class="">
  154. <a class="" href="../Security/">Security</a>
  155. </li>
  156. <li class="">
  157. <a class="" href="../Static-analysis/">Static analysis</a>
  158. </li>
  159. <li class="">
  160. <a class="" href="../Theming/">Theming</a>
  161. </li>
  162. <li class="">
  163. <a class="" href="../Unit-tests/">Unit tests</a>
  164. </li>
  165. </ul>
  166. </li>
  167. <li class="toctree-l1">
  168. <span class="caption-text">About</span>
  169. <ul class="subnav">
  170. <li class="">
  171. <a class="" href="../FAQ/">FAQ</a>
  172. </li>
  173. <li class="">
  174. <a class="" href="../Community-&-Related-software/">Community & Related software</a>
  175. </li>
  176. </ul>
  177. </li>
  178. </ul>
  179. </div>
  180. &nbsp;
  181. </nav>
  182. <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
  183. <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
  184. <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
  185. <a href="..">Shaarli Documentation</a>
  186. </nav>
  187. <div class="wy-nav-content">
  188. <div class="rst-content">
  189. <div role="navigation" aria-label="breadcrumbs navigation">
  190. <ul class="wy-breadcrumbs">
  191. <li><a href="..">Docs</a> &raquo;</li>
  192. <li>Development &raquo;</li>
  193. <li>Directory structure</li>
  194. <li class="wy-breadcrumbs-aside">
  195. <a href="https://github.com/shaarli/Shaarli/edit/master/docs/Directory-structure.md"
  196. class="icon icon-github"> Edit on GitHub</a>
  197. </li>
  198. </ul>
  199. <hr/>
  200. </div>
  201. <div role="main">
  202. <div class="section">
  203. <p>Here is the directory structure of Shaarli and the purpose of the different files:</p>
  204. <pre><code class="bash"> index.php # Main program
  205. application/ # Shaarli classes
  206. ├── LinkDB.php
  207. └── Utils.php
  208. tests/ # Shaarli unitary &amp; functional tests
  209. ├── LinkDBTest.php
  210. ├── utils # utilities to ease testing
  211. │ └── ReferenceLinkDB.php
  212. └── UtilsTest.php
  213. COPYING # Shaarli license
  214. inc/ # static assets and 3rd party libraries
  215. ├── awesomplete.* # tags autocompletion library
  216. ├── blazy.* # picture wall lazy image loading library
  217. ├── shaarli.css, reset.css # Shaarli stylesheet.
  218. ├── qr.* # qr code generation library
  219. └──rain.tpl.class.php # RainTPL templating library
  220. tpl/ # RainTPL templates for Shaarli. They are used to build the pages.
  221. images/ # Images and icons used in Shaarli
  222. data/ # data storage: bookmark database, configuration, logs, banlist…
  223. ├── config.php # Shaarli configuration (login, password, timezone, title…)
  224. ├── datastore.php # Your link database (compressed).
  225. ├── ipban.php # IP address ban system data
  226. ├── lastupdatecheck.txt # Update check timestamp file
  227. └──log.txt # login/IPban log.
  228. cache/ # thumbnails cache
  229. # This directory is automatically created. You can erase it anytime you want.
  230. tmp/ # Temporary directory for compiled RainTPL templates.
  231. # This directory is automatically created. You can erase it anytime you want.
  232. </code></pre>
  233. </div>
  234. </div>
  235. <footer>
  236. <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
  237. <a href="../3rd-party-libraries/" class="btn btn-neutral float-right" title="3rd party libraries">Next <span class="icon icon-circle-arrow-right"></span></a>
  238. <a href="../Coding-guidelines/" class="btn btn-neutral" title="Coding guidelines"><span class="icon icon-circle-arrow-left"></span> Previous</a>
  239. </div>
  240. <hr/>
  241. <div role="contentinfo">
  242. <!-- Copyright etc -->
  243. </div>
  244. Built with <a href="http://www.mkdocs.org">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
  245. </footer>
  246. </div>
  247. </div>
  248. </section>
  249. </div>
  250. <div class="rst-versions" role="note" style="cursor: pointer">
  251. <span class="rst-current-version" data-toggle="rst-current-version">
  252. <a href="https://github.com/shaarli/Shaarli" class="fa fa-github" style="float: left; color: #fcfcfc"> GitHub</a>
  253. <span><a href="../Coding-guidelines/" style="color: #fcfcfc;">&laquo; Previous</a></span>
  254. <span style="margin-left: 15px"><a href="../3rd-party-libraries/" style="color: #fcfcfc">Next &raquo;</a></span>
  255. </span>
  256. </div>
  257. <script src="../js/theme.js"></script>
  258. </body>
  259. </html>