larecipe.php 6.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198
  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' => '/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' => '1.4.6',
  32. 'published' => [
  33. '1.4.6'
  34. ]
  35. ],
  36. /*
  37. |--------------------------------------------------------------------------
  38. | Documentation Settings
  39. |--------------------------------------------------------------------------
  40. |
  41. | These options configure the additional behaviors of your documentation
  42. | where you can limit the access to only authenticated users in your
  43. | system. It is false initially so that guests can view your docs.
  44. |
  45. |
  46. */
  47. 'settings' => [
  48. 'auth' => false,
  49. 'ga_id' => ''
  50. ],
  51. /*
  52. |--------------------------------------------------------------------------
  53. | Cache
  54. |--------------------------------------------------------------------------
  55. |
  56. | Obviously rendering markdown at the back-end is costly especially if
  57. | the rendered files are massive. Thankfully, caching is considered
  58. | as a good option to speed up your app when having high traffic.
  59. |
  60. | Caching period unit: minutes
  61. |
  62. */
  63. 'cache' => [
  64. 'enabled' => env('LARECIPE_DOCS_CACHED', true),
  65. 'period' => 5
  66. ],
  67. /*
  68. |--------------------------------------------------------------------------
  69. | Search
  70. |--------------------------------------------------------------------------
  71. |
  72. | Here you can add configure the search functionality of your docs.
  73. | You can choose the default engine of your search from the list
  74. | However, you can also enable/disable the search's visibility
  75. |
  76. | Supported Search Engines: 'algolia'
  77. |
  78. */
  79. 'search' => [
  80. 'enabled' => false,
  81. 'default' => 'algolia',
  82. 'engines' => [
  83. 'algolia' => [
  84. 'key' => '',
  85. 'index' => ''
  86. ]
  87. ]
  88. ],
  89. /*
  90. |--------------------------------------------------------------------------
  91. | Documentation Repository
  92. |--------------------------------------------------------------------------
  93. |
  94. | This is an optional config you can set in order to show an external link
  95. | to your documentation's repository if you have one. Once you set the
  96. | value of the url, LaRecipe automatically will show the nav button.
  97. |
  98. |
  99. */
  100. 'repository' => [
  101. 'provider' => 'github',
  102. 'url' => 'https://github.com/Laracommerce/laracom'
  103. ],
  104. /*
  105. |--------------------------------------------------------------------------
  106. | Appearance
  107. |--------------------------------------------------------------------------
  108. |
  109. | Here you can add configure the appearance of your docs. For example,
  110. | you can swap the default logo to custom one that matches your Id
  111. | Also, you can change the theme of your docs if you prefer that
  112. |
  113. | Supported Themes: 'light', 'dark'
  114. |
  115. */
  116. 'ui' => [
  117. 'show_app_name' => true,
  118. 'logo' => '', // e.g.: /images/logo.svg
  119. 'fav' => '', // e.g.: /fav.png
  120. 'theme' => 'light',
  121. 'code' => 'dark',
  122. 'back_to_top' => true,
  123. 'show_side_bar' => true,
  124. 'colors' => [
  125. 'primary' => '#787AF6',
  126. 'secondary' => '#2b9cf2',
  127. 'selection' => '#f4f5f7'
  128. ],
  129. 'additional_css' => [
  130. //'css/custom.css',
  131. ],
  132. 'additional_js' => [
  133. //'js/custom.js',
  134. ],
  135. ],
  136. /*
  137. |--------------------------------------------------------------------------
  138. | SEO
  139. |--------------------------------------------------------------------------
  140. |
  141. | These options configure the SEO settings of your docs. You can set the
  142. | author, the description and the keywords. Also, LaRecipe by default
  143. | sets the canonical link to the viewed page's link automatically.
  144. |
  145. |
  146. */
  147. 'seo' => [
  148. 'author' => '',
  149. 'description' => '',
  150. 'keywords' => '',
  151. 'og' => [
  152. 'title' => '',
  153. 'type' => 'article',
  154. 'url' => '',
  155. 'image' => '',
  156. 'description' => '',
  157. ]
  158. ],
  159. /*
  160. |--------------------------------------------------------------------------
  161. | Forum
  162. |--------------------------------------------------------------------------
  163. |
  164. | Giving a chance to your users to post thier questions or feedback
  165. | directly on your docs, is pretty nice way to engage them more.
  166. | However, you can also enable/disable the forum's visibility.
  167. |
  168. | Supported Services: 'disqus'
  169. |
  170. */
  171. 'forum' => [
  172. 'enabled' => false,
  173. 'default' => 'disqus',
  174. 'services' => [
  175. 'disqus' => [
  176. 'site_name' => '', // yoursite.disqus.com
  177. ]
  178. ]
  179. ]
  180. ];