larecipe.php 5.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191
  1. <?php
  2. return [
  3. /*
  4. |--------------------------------------------------------------------------
  5. | Documentation Routes
  6. |--------------------------------------------------------------------------
  7. |
  8. | These options configure the behavior of the LaRecipe docs basic route
  9. | where you can specify the url of your documentations, the location
  10. | of your docs and the landing page when a user visits /docs route.
  11. |
  12. |
  13. */
  14. 'docs' => [
  15. 'route' => '/stub-docs',
  16. 'path' => '/resources/docs',
  17. 'landing' => 'overview',
  18. ],
  19. /*
  20. |--------------------------------------------------------------------------
  21. | Documentation Versions
  22. |--------------------------------------------------------------------------
  23. |
  24. | Here you may specify and set the versions and the default (latest) one
  25. | of your documentation's versions where you can redirect the user to.
  26. | Just make sure that the default version is in the published list.
  27. |
  28. |
  29. */
  30. 'versions' => [
  31. 'default' => 'ErrorCodes',
  32. 'published' => [
  33. 'ErrorCodes',
  34. 'V1',
  35. 'V1_1'
  36. ]
  37. ],
  38. /*
  39. |--------------------------------------------------------------------------
  40. | Documentation Settings
  41. |--------------------------------------------------------------------------
  42. |
  43. | These options configure the additional behaviors of your documentation
  44. | where you can limit the access to only authenticated users in your
  45. | system. It is false initially so that guests can view your docs.
  46. |
  47. |
  48. */
  49. 'settings' => [
  50. 'auth' => false,
  51. 'ga_id' => ''
  52. ],
  53. /*
  54. |--------------------------------------------------------------------------
  55. | Cache
  56. |--------------------------------------------------------------------------
  57. |
  58. | Obviously rendering markdown at the back-end is costly especially if
  59. | the rendered files are massive. Thankfully, caching is considered
  60. | as a good option to speed up your app when having high traffic.
  61. |
  62. | Caching period unit: minutes
  63. |
  64. */
  65. 'cache' => [
  66. 'enabled' => false,
  67. 'period' => 5
  68. ],
  69. /*
  70. |--------------------------------------------------------------------------
  71. | Search
  72. |--------------------------------------------------------------------------
  73. |
  74. | Here you can add configure the search functionality of your docs.
  75. | You can choose the default engine of your search from the list
  76. | However, you can also enable/disable the search's visibility
  77. |
  78. | Supported Search Engines: 'algolia', 'internal'
  79. |
  80. */
  81. 'search' => [
  82. 'enabled' => false,
  83. 'default' => 'algolia',
  84. 'engines' => [
  85. 'internal' => [
  86. 'index' => ['h2', 'h3']
  87. ],
  88. 'algolia' => [
  89. 'key' => '',
  90. 'index' => ''
  91. ]
  92. ]
  93. ],
  94. /*
  95. |--------------------------------------------------------------------------
  96. | Appearance
  97. |--------------------------------------------------------------------------
  98. |
  99. | Here you can add configure the appearance of your docs. For example,
  100. | you can set the primary and secondary colors that will give your
  101. | documentation a unique look. You can set the fav of your docs.
  102. |
  103. |
  104. */
  105. 'ui' => [
  106. 'code_theme' => 'dark', // or: light
  107. 'fav' => '', // eg: fav.png
  108. 'fa_v4_shims' => true, // Add FontAwesome v4 shims prevent BC break
  109. 'colors' => [
  110. 'primary' => '#787AF6',
  111. 'secondary' => '#2b9cf2'
  112. ],
  113. ],
  114. /*
  115. |--------------------------------------------------------------------------
  116. | SEO
  117. |--------------------------------------------------------------------------
  118. |
  119. | These options configure the SEO settings of your docs. You can set the
  120. | author, the description and the keywords. Also, LaRecipe by default
  121. | sets the canonical link to the viewed page's link automatically.
  122. |
  123. |
  124. */
  125. 'seo' => [
  126. 'author' => '',
  127. 'description' => '',
  128. 'keywords' => '',
  129. 'og' => [
  130. 'title' => '',
  131. 'type' => 'article',
  132. 'url' => '',
  133. 'image' => '',
  134. 'description' => '',
  135. ]
  136. ],
  137. /*
  138. |--------------------------------------------------------------------------
  139. | Forum
  140. |--------------------------------------------------------------------------
  141. |
  142. | Giving a chance to your users to post their questions or feedback
  143. | directly on your docs, is pretty nice way to engage them more.
  144. | However, you can also enable/disable the forum's visibility.
  145. |
  146. | Supported Services: 'disqus'
  147. |
  148. */
  149. 'forum' => [
  150. 'enabled' => false,
  151. 'default' => 'disqus',
  152. 'services' => [
  153. 'disqus' => [
  154. 'site_name' => '', // yoursite.disqus.com
  155. ]
  156. ]
  157. ],
  158. /*
  159. |--------------------------------------------------------------------------
  160. | Components and Packages
  161. |--------------------------------------------------------------------------
  162. |
  163. | Once you create a new asset or theme, its directory will be
  164. | published under `larecipe-components` folder. However, If
  165. | you want a different location, feel free to change it.
  166. |
  167. |
  168. */
  169. 'packages' => [
  170. 'path' => 'larecipe-components',
  171. ]
  172. ];