scrapbook 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 19b4fdaf3007e60e0cd40c09d70fe04ee9c9b522552dc0060f718aba02fcaadd
-  data.tar.gz: 015d92510a0e2eacff22b81d163983de1ff88d2bc60f7f523e69dbfbc841d591
+  metadata.gz: ef6dc0f95ede6ecc1b68f75aaac825101f84252d5f7b8724e2b59534d40c083f
+  data.tar.gz: 6bd20440efd3e0ed318a5d1103c364600163fd48e3fd72f497e221ae07a08cc0
 SHA512:
-  metadata.gz: c23dc644bb467bd0655a781615095e6cb74fd7ccc47dc0281a1877089bf42617fae23cbc182d290b437f96669328a899cda705a7ea69c299df0fb9f0e58f39c3
-  data.tar.gz: 379b7626edd2752d95c039d6daaf947f668c0dc4a1571685b58879a11509987df0da474184a4f37896c1585135e0ea7bc7be9c044e80bc78385a2f0566c287dc
+  metadata.gz: e031db1caa0fdc1aea56a3efc5a969b8990305bf3263c7f8445bc7b66908390008465488031819774cfc3404298f9c1eac3cb18ec1c82b122e210f964652c33a
+  data.tar.gz: ff32ea7dad5cadb5f6d88ca444bb803033681f7845c99d4371645e0000da87de6d40609cf46d4c9fa4121cbca36cd2678ba519a49c127ade364fd6616e9d49ae

data/README.md

@@ -31,8 +31,9 @@ $> bundle install
 $> bundle exec rails generate scrapbook:install
 ```
 
-This will install the gem and setup the default Scrapbook route and create the default
-scrapbook directory structure at the root of your Rails application.
+This will install the gem and then setup a scrapbook directory structure with a folder named
+"scrapbook" at the root of your Rails application as well as modify your routes to make the
+scrapbook available.
 
 ## Usage
 
@@ -48,38 +49,32 @@ the main display area describing how to customize what is displayed when a folde
 selected. In short, you need to create a template file with the same base name as the folder
 in the same directory as the folder. So if you had a folder at "scrapbook/pages/scratch",
 then you would need to create a file named something like "scrapbook/pages/scratch.html.erb"
-with the custom display you want to see when you click on the "scratch" folder in the file
+with the custom view you want to see when you click on the "scratch" folder in the file
 browser. This also works for the main screen you see at the base scrapbook URL. You can
 customize that screen by creating a "pages.html" template file in the root scrapbook folder.
 (The default installation creates a "pages.html.erb" template file for the basic welcome
 message.)
 
-To view a scrapbook, navigate to its base URL. The default scarpbook can always be accessed
-at the mountpoint setup in the routes file (this is "/scrapbook" by default). The base URL
-for other scrapbooks is that path followed by the name of the scrapbook's root folder (the
-folder that contains the "pages" folder). By default, only one scrapbook is configured and
-it's name is "scrapbook" which means that both "/scrapbook" and "/scrapbook/scrapbook" point
-to the same scrapbook root page.
+To view a scrapbook, navigate to its base URL setup by the route file configuration. (See
+the documentation for the `scrapbook` route helper for more information on how to conigure
+this route.)
 
 ## Configuration
 
-You can configure the path that Scrapbook runs on in your "config/routes.rb" file. The
-default configuration is to mount Scrapbook on "/scrapbook", but you can use whatever
-path you want: `mount Scrapbook::Engine => "/scrappy"`.
+The installation task adds `extend Scrapbook::Routing` to the routes configuration block
+which gives it access to the `scrapbook` route helper. It also addds a scrapbook named
+"scrapbook" using that helper (`scrapbook('scrapbook')`). You can modify that configuration,
+specifying the location of the folder root or the URL path to mount the scrapbook at. You
+can also add additional scrapbooks using this helper. For example:
 
-You can configure one or more folders to be separate root scrapbooks via the
-`config.scrapbook.paths` option. This option defaults to an empty array which allows for
-using the shovel operator to add your paths:
 ```ruby
-Rails.application.configure do
-  config.scrapbook.paths << Rails.root.join("scrapbooks/main")
-  config.scrapbook.paths << Rails.root.join("scrapbooks/scratch")
+Rails.application.routes.draw do
+  extend Scrapbook::Routing
+
+  scrapbook('main', at: '/scrapbook', folder_root: 'scrapbooks/main')
+  scrapbook('scratch', folder_root: 'scrapbooks/scratch')
 end
 ```
-If no paths have been added, Scrapbook will use `Rails.root.join('scrapbook')` as the
-location it expects the scrapbook to be at. The first folder path in the array is considered
-the default scrapbook and will be available at the root mount point configured in the routes
-file.
 
 We recommend only running Scrapbook in development / non-production Rails environments.
 However, if you find yourself needing to be able to run it in an environment precompiles its
@@ -122,6 +117,12 @@ $> npx tailwindcss -i app/assets/stylesheets/scrapbook/application.tailwind.css
 (Note, the "tailwindcss-rails" gem currently doesn't support Rails engines, so we have to
 install and run Tailwind manually.)
 
+## Updating the Turbo javascript
+
+- Download the compiled JS file from the turbo rails gem. (The releases on the Turbo website
+  didn't include it.)
+- Comment out or remove the `export` statement towards the end.
+
 ## License
 
 Copyright 2022 Brad Lindsay

data/app/assets/builds/scrapbook/application.css

@@ -1 +1 @@
-/*! tailwindcss v3.0.23 | MIT License | https://tailwindcss.com*/*,:after,:before{box-sizing:border-box;border:0 solid #e5e7eb}:after,:before{--tw-content:""}html{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica Neue,Arial,Noto Sans,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,pre,samp{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:initial}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}[type=button],[type=reset],[type=submit],button{-webkit-appearance:button;background-color:initial;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:initial}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dd,dl,figure,h1,h2,h3,h4,h5,h6,hr,p,pre{margin:0}fieldset{margin:0}fieldset,legend{padding:0}menu,ol,ul{list-style:none;margin:0;padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input:-ms-input-placeholder,textarea:-ms-input-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}[role=button],button{cursor:pointer}:disabled{cursor:default}audio,canvas,embed,iframe,img,object,svg,video{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]{display:none}[multiple],[type=date],[type=datetime-local],[type=email],[type=month],[type=number],[type=password],[type=search],[type=tel],[type=text],[type=time],[type=url],[type=week],select,textarea{-webkit-appearance:none;-moz-appearance:none;appearance:none;background-color:#fff;border-color:#6b7280;border-width:1px;border-radius:0;padding:.5rem .75rem;font-size:1rem;line-height:1.5rem;--tw-shadow:0 0 #0000}[multiple]:focus,[type=date]:focus,[type=datetime-local]:focus,[type=email]:focus,[type=month]:focus,[type=number]:focus,[type=password]:focus,[type=search]:focus,[type=tel]:focus,[type=text]:focus,[type=time]:focus,[type=url]:focus,[type=week]:focus,select:focus,textarea:focus{outline:2px solid #0000;outline-offset:2px;--tw-ring-inset:var(--tw-empty,/*!*/ /*!*/);--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:#2563eb;--tw-ring-offset-shadow:var(--tw-ring-inset) 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color);--tw-ring-shadow:var(--tw-ring-inset) 0 0 0 calc(1px + var(--tw-ring-offset-width)) var(--tw-ring-color);box-shadow:var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow);border-color:#2563eb}input::-moz-placeholder,textarea::-moz-placeholder{color:#6b7280;opacity:1}input:-ms-input-placeholder,textarea:-ms-input-placeholder{color:#6b7280;opacity:1}input::placeholder,textarea::placeholder{color:#6b7280;opacity:1}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-date-and-time-value{min-height:1.5em}::-webkit-datetime-edit,::-webkit-datetime-edit-day-field,::-webkit-datetime-edit-hour-field,::-webkit-datetime-edit-meridiem-field,::-webkit-datetime-edit-millisecond-field,::-webkit-datetime-edit-minute-field,::-webkit-datetime-edit-month-field,::-webkit-datetime-edit-second-field,::-webkit-datetime-edit-year-field{padding-top:0;padding-bottom:0}select{background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 20 20'%3E%3Cpath stroke='%236b7280' stroke-linecap='round' stroke-linejoin='round' stroke-width='1.5' d='m6 8 4 4 4-4'/%3E%3C/svg%3E");background-position:right .5rem center;background-repeat:no-repeat;background-size:1.5em 1.5em;padding-right:2.5rem;-webkit-print-color-adjust:exact;color-adjust:exact}[multiple]{background-image:none;background-position:0 0;background-repeat:unset;background-size:initial;padding-right:.75rem;-webkit-print-color-adjust:unset;color-adjust:unset}[type=checkbox],[type=radio]{-webkit-appearance:none;-moz-appearance:none;appearance:none;padding:0;-webkit-print-color-adjust:exact;color-adjust:exact;display:inline-block;vertical-align:middle;background-origin:border-box;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;flex-shrink:0;height:1rem;width:1rem;color:#2563eb;background-color:#fff;border-color:#6b7280;border-width:1px;--tw-shadow:0 0 #0000}[type=checkbox]{border-radius:0}[type=radio]{border-radius:100%}[type=checkbox]:focus,[type=radio]:focus{outline:2px solid #0000;outline-offset:2px;--tw-ring-inset:var(--tw-empty,/*!*/ /*!*/);--tw-ring-offset-width:2px;--tw-ring-offset-color:#fff;--tw-ring-color:#2563eb;--tw-ring-offset-shadow:var(--tw-ring-inset) 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color);--tw-ring-shadow:var(--tw-ring-inset) 0 0 0 calc(2px + var(--tw-ring-offset-width)) var(--tw-ring-color);box-shadow:var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}[type=checkbox]:checked,[type=radio]:checked{border-color:#0000;background-color:currentColor;background-size:100% 100%;background-position:50%;background-repeat:no-repeat}[type=checkbox]:checked{background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg viewBox='0 0 16 16' fill='%23fff' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M12.207 4.793a1 1 0 0 1 0 1.414l-5 5a1 1 0 0 1-1.414 0l-2-2a1 1 0 0 1 1.414-1.414L6.5 9.086l4.293-4.293a1 1 0 0 1 1.414 0z'/%3E%3C/svg%3E")}[type=radio]:checked{background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg viewBox='0 0 16 16' fill='%23fff' xmlns='http://www.w3.org/2000/svg'%3E%3Ccircle cx='8' cy='8' r='3'/%3E%3C/svg%3E")}[type=checkbox]:checked:focus,[type=checkbox]:checked:hover,[type=checkbox]:indeterminate,[type=radio]:checked:focus,[type=radio]:checked:hover{border-color:#0000;background-color:currentColor}[type=checkbox]:indeterminate{background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 16 16'%3E%3Cpath stroke='%23fff' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M4 8h8'/%3E%3C/svg%3E");background-size:100% 100%;background-position:50%;background-repeat:no-repeat}[type=checkbox]:indeterminate:focus,[type=checkbox]:indeterminate:hover{border-color:#0000;background-color:currentColor}[type=file]{background:unset;border-color:inherit;border-width:0;border-radius:0;padding:0;font-size:unset;line-height:inherit}[type=file]:focus{outline:1px auto -webkit-focus-ring-color}body>nav li{cursor:default}body>nav a,body>nav a:active,body>nav a:hover,body>nav a:visited{color:#0f172a;cursor:default;text-decoration:none;transition:background-color 80ms linear;font-weight:400;font-size:unset;line-height:inherit}body>nav a:hover{background-color:#f0f9ff}body>nav a:active{background-color:#bae6fd}*,:after,:before{--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:#3b82f680;--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: }.block{display:block}.flex{display:flex}.contents{display:contents}.h-screen{height:100vh}.h-full{height:100%}.w-screen{width:100vw}.w-full{width:100%}.min-w-\[20ch\]{min-width:20ch}.max-w-\[50\%\]{max-width:50%}.flex-none{flex:none}.overflow-scroll{overflow:scroll}.border-0{border-width:0}.border-r{border-right-width:1px}.border-solid{border-style:solid}.border-sky-700{--tw-border-opacity:1;border-color:rgb(3 105 161/var(--tw-border-opacity))}.bg-sky-100{--tw-bg-opacity:1;background-color:rgb(224 242 254/var(--tw-bg-opacity))}.\!px-0{padding-left:0!important;padding-right:0!important}.py-2{padding-top:.5rem;padding-bottom:.5rem}.px-4{padding-left:1rem;padding-right:1rem}.text-2xl{font-size:1.5rem;line-height:2rem}.children\:px-4>*{padding-left:1rem;padding-right:1rem}
+/*! tailwindcss v3.2.1 | MIT License | https://tailwindcss.com*/*,:after,:before{box-sizing:border-box;border:0 solid #e5e7eb}:after,:before{--tw-content:""}html{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica Neue,Arial,Noto Sans,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,pre,samp{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:initial}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;font-weight:inherit;line-height:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}[type=button],[type=reset],[type=submit],button{-webkit-appearance:button;background-color:initial;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:initial}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dd,dl,figure,h1,h2,h3,h4,h5,h6,hr,p,pre{margin:0}fieldset{margin:0}fieldset,legend{padding:0}menu,ol,ul{list-style:none;margin:0;padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}[role=button],button{cursor:pointer}:disabled{cursor:default}audio,canvas,embed,iframe,img,object,svg,video{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]{display:none}[multiple],[type=date],[type=datetime-local],[type=email],[type=month],[type=number],[type=password],[type=search],[type=tel],[type=text],[type=time],[type=url],[type=week],select,textarea{-webkit-appearance:none;-moz-appearance:none;appearance:none;background-color:#fff;border-color:#6b7280;border-width:1px;border-radius:0;padding:.5rem .75rem;font-size:1rem;line-height:1.5rem;--tw-shadow:0 0 #0000}[multiple]:focus,[type=date]:focus,[type=datetime-local]:focus,[type=email]:focus,[type=month]:focus,[type=number]:focus,[type=password]:focus,[type=search]:focus,[type=tel]:focus,[type=text]:focus,[type=time]:focus,[type=url]:focus,[type=week]:focus,select:focus,textarea:focus{outline:2px solid #0000;outline-offset:2px;--tw-ring-inset:var(--tw-empty,/*!*/ /*!*/);--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:#2563eb;--tw-ring-offset-shadow:var(--tw-ring-inset) 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color);--tw-ring-shadow:var(--tw-ring-inset) 0 0 0 calc(1px + var(--tw-ring-offset-width)) var(--tw-ring-color);box-shadow:var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow);border-color:#2563eb}input::-moz-placeholder,textarea::-moz-placeholder{color:#6b7280;opacity:1}input::placeholder,textarea::placeholder{color:#6b7280;opacity:1}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-date-and-time-value{min-height:1.5em}::-webkit-datetime-edit,::-webkit-datetime-edit-day-field,::-webkit-datetime-edit-hour-field,::-webkit-datetime-edit-meridiem-field,::-webkit-datetime-edit-millisecond-field,::-webkit-datetime-edit-minute-field,::-webkit-datetime-edit-month-field,::-webkit-datetime-edit-second-field,::-webkit-datetime-edit-year-field{padding-top:0;padding-bottom:0}select{background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 20 20'%3E%3Cpath stroke='%236b7280' stroke-linecap='round' stroke-linejoin='round' stroke-width='1.5' d='m6 8 4 4 4-4'/%3E%3C/svg%3E");background-position:right .5rem center;background-repeat:no-repeat;background-size:1.5em 1.5em;padding-right:2.5rem;-webkit-print-color-adjust:exact;print-color-adjust:exact}[multiple]{background-image:none;background-position:0 0;background-repeat:unset;background-size:initial;padding-right:.75rem;-webkit-print-color-adjust:unset;print-color-adjust:unset}[type=checkbox],[type=radio]{-webkit-appearance:none;-moz-appearance:none;appearance:none;padding:0;-webkit-print-color-adjust:exact;print-color-adjust:exact;display:inline-block;vertical-align:middle;background-origin:border-box;-webkit-user-select:none;-moz-user-select:none;user-select:none;flex-shrink:0;height:1rem;width:1rem;color:#2563eb;background-color:#fff;border-color:#6b7280;border-width:1px;--tw-shadow:0 0 #0000}[type=checkbox]{border-radius:0}[type=radio]{border-radius:100%}[type=checkbox]:focus,[type=radio]:focus{outline:2px solid #0000;outline-offset:2px;--tw-ring-inset:var(--tw-empty,/*!*/ /*!*/);--tw-ring-offset-width:2px;--tw-ring-offset-color:#fff;--tw-ring-color:#2563eb;--tw-ring-offset-shadow:var(--tw-ring-inset) 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color);--tw-ring-shadow:var(--tw-ring-inset) 0 0 0 calc(2px + var(--tw-ring-offset-width)) var(--tw-ring-color);box-shadow:var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}[type=checkbox]:checked,[type=radio]:checked{border-color:#0000;background-color:currentColor;background-size:100% 100%;background-position:50%;background-repeat:no-repeat}[type=checkbox]:checked{background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg viewBox='0 0 16 16' fill='%23fff' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M12.207 4.793a1 1 0 0 1 0 1.414l-5 5a1 1 0 0 1-1.414 0l-2-2a1 1 0 0 1 1.414-1.414L6.5 9.086l4.293-4.293a1 1 0 0 1 1.414 0z'/%3E%3C/svg%3E")}[type=radio]:checked{background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg viewBox='0 0 16 16' fill='%23fff' xmlns='http://www.w3.org/2000/svg'%3E%3Ccircle cx='8' cy='8' r='3'/%3E%3C/svg%3E")}[type=checkbox]:checked:focus,[type=checkbox]:checked:hover,[type=checkbox]:indeterminate,[type=radio]:checked:focus,[type=radio]:checked:hover{border-color:#0000;background-color:currentColor}[type=checkbox]:indeterminate{background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 16 16'%3E%3Cpath stroke='%23fff' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M4 8h8'/%3E%3C/svg%3E");background-size:100% 100%;background-position:50%;background-repeat:no-repeat}[type=checkbox]:indeterminate:focus,[type=checkbox]:indeterminate:hover{border-color:#0000;background-color:currentColor}[type=file]{background:unset;border-color:inherit;border-width:0;border-radius:0;padding:0;font-size:unset;line-height:inherit}[type=file]:focus{outline:1px solid ButtonText;outline:1px auto -webkit-focus-ring-color}body>nav li{cursor:default}body>nav a,body>nav a:active,body>nav a:hover,body>nav a:visited{color:#0f172a;cursor:default;text-decoration:none;transition:background-color 80ms linear;font-weight:400;font-size:unset;line-height:inherit}turbo-frame{display:block}*,:after,:before{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:#3b82f680;--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: }::-webkit-backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:#3b82f680;--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:#3b82f680;--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: }.block{display:block}.flex{display:flex}.contents{display:contents}.h-screen{height:100vh}.h-full{height:100%}.w-screen{width:100vw}.w-full{width:100%}.min-w-\[20ch\]{min-width:20ch}.max-w-\[50\%\]{max-width:50%}.flex-none{flex:none}.grow{flex-grow:1}.overflow-scroll{overflow:scroll}.border-0{border-width:0}.border-r{border-right-width:1px}.border-solid{border-style:solid}.border-sky-700{--tw-border-opacity:1;border-color:rgb(3 105 161/var(--tw-border-opacity))}.\!px-0{padding-left:0!important;padding-right:0!important}.py-2{padding-top:.5rem;padding-bottom:.5rem}.px-4{padding-left:1rem;padding-right:1rem}.text-2xl{font-size:1.5rem;line-height:2rem}summary{list-style:none}summary::-webkit-details-marker{display:none}details>summary:before{content:"▶︎";font-size:.8rem;flex:none;line-height:1.6rem;margin-right:.4rem;transition:rotate .2s ease-in-out}details[open]>summary:before{rotate:90deg;transition:rotate .2s ease-in-out}.hover\:bg-sky-50:hover{--tw-bg-opacity:1;background-color:rgb(240 249 255/var(--tw-bg-opacity))}.active\:bg-sky-200:active{--tw-bg-opacity:1;background-color:rgb(186 230 253/var(--tw-bg-opacity))}.children\:px-4>*{padding-left:1rem;padding-right:1rem}.\[\&\:has\(\[aria-current\=page\]\)\]\:bg-sky-100:has([aria-current=page]){--tw-bg-opacity:1;background-color:rgb(224 242 254/var(--tw-bg-opacity))}

data/app/assets/config/scrapbook_manifest.js

@@ -1 +1,2 @@
 //= link_directory ../stylesheets/scrapbook .css
+//= link_directory ../javascripts .js

data/app/assets/javascripts/scrapbook/application.js

@@ -0,0 +1,115 @@
+//= require scrapbook/turbo.min
+
+function ready(fn) {
+  if (document.readyState !== 'loading') {
+    fn()
+  } else {
+    document.addEventListener('DOMContentLoaded', fn)
+  }
+}
+ready(() => {
+  const scrapbook_root_path = document.head.querySelector("meta[name=scrapbook-root]").content
+
+  function buildInitialTree() {
+    const paths = window.location.pathname.substring(scrapbook_root_path.length).split("/")
+    if (paths.length === 1 && paths[0] === "") { return }
+
+    fetch(scrapbook_root_path)
+      .then((response) => response.text())
+      .then((data) => {
+        const root = document.createElement('html')
+        const nav = document.getElementById('folder_listing')
+        const frame = nav.querySelector('turbo-frame')
+
+        root.innerHTML = data
+        // Keep the nav element to keep listeners on it intact.
+        nav.innerHTML = root.querySelector('#folder_listing').innerHTML
+        setCurrent()
+
+        openFolderPath(window.location.pathname, scrapbook_root_path + paths[0])
+      })
+      .catch((error) => {
+        console.error("Unknown error:", error)
+      })
+  }
+
+  function openFolderPath(path, currentSubPath = scrapbook_root_path) {
+    const frame = document.querySelector('turbo-frame[src="' + currentSubPath + '"]')
+    if (!frame) { return }
+
+    if (path !== currentSubPath)
+      frame.addEventListener('turbo:frame-render', () => {
+        nextSegment = path.replace(currentSubPath + '/', '').split('/')[0]
+        openFolderPath(path, currentSubPath + '/' + nextSegment)
+      }, {once: true})
+    frame.parentElement.open = true
+  }
+
+  function runOpenFor(ids) {
+    const idsLeft = []
+    const framesFound = []
+
+    ids.forEach((id) => {
+      let frame = document.getElementById(id)
+      !frame ? idsLeft.push(id) : framesFound.push(frame)
+    })
+
+    framesFound.forEach((frame) => {
+      frame.addEventListener('turbo:frame-render', () => {
+        runOpenFor(idsLeft)
+      }, {once: true})
+      frame.parentElement.open = true
+    })
+  }
+
+  function setCurrent(link = document.querySelector('#folder_listing a[href="' + window.location.pathname + '"]')) {
+    if (link === null) { return }
+
+    oldSelection = document.querySelector('#folder_listing a[aria-current="page"]')
+    if (oldSelection == link) { return }
+
+    if (oldSelection) {
+      oldSelection.removeAttribute('aria-current', 'page')
+    }
+
+    link.setAttribute('aria-current', 'page')
+  }
+
+
+  buildInitialTree()
+  folderListingElem = document.getElementById("folder_listing")
+
+  // Update selection when a link is clicked
+  folderListingElem.addEventListener('click', (e) => {
+    const target = e.target
+    if (target.tagName != 'A') { return }
+
+    setCurrent(target)
+  })
+
+  // Every time a folder is opened, it's possible to be re-revealing the selected page.
+  folderListingElem.addEventListener('turbo:frame-render', () => {
+    setCurrent()
+  })
+
+  // Refresh trees when a folder is toggled back open
+  // The first time a details element is toggled open, the turbo frame lazily loads. This
+  // adds support for reloading whenever the element is closed and then re-opened. All
+  // turbo frames of any nested folders are also refreshed.
+  folderListingElem.addEventListener('toggle', (e) => {
+    if (!e.target.open) { return }
+    if ('loadedOnce' in e.target.dataset === false) {
+      e.target.dataset.loadedOnce = true
+      return
+    }
+
+    const idsToOpen = []
+    e.target.querySelectorAll('details[open] > turbo-frame').forEach(elem => idsToOpen.push(elem.id))
+
+    const firstFrame = document.getElementById(idsToOpen.shift())
+    firstFrame.addEventListener('turbo:frame-render', () => {
+      runOpenFor(idsToOpen)
+    }, {once: true})
+    firstFrame.reload()
+  }, {capture: true})
+})

data/app/assets/stylesheets/scrapbook/application.tailwind.css

@@ -22,11 +22,24 @@
     line-height:inherit;
   }
 
-  body > nav a:hover {
-    background-color: theme('colors.sky.50');
+  turbo-frame {
+    display: block;
   }
+}
 
-  body > nav a:active {
-    background-color: theme('colors.sky.200');
-  }
+summary { list-style: none; }
+summary::-webkit-details-marker { display: none; }
+
+details > summary::before {
+  content: "▶︎";
+  font-size: 0.8rem;
+  flex: none;
+  line-height: 1.6rem;
+  margin-right: 0.4rem;
+  transition: rotate 0.2s ease-in-out;
+}
+
+details[open] > summary::before {
+  rotate: 90deg;
+  transition: rotate 0.2s ease-in-out;
 }

data/app/controllers/scrapbook/pages_controller.rb

@@ -5,26 +5,16 @@ module Scrapbook
   class PagesController < ApplicationController
     self.view_paths = Engine.config.paths['app/views'].to_a
 
-    def index
-      return head(:not_found) if (scrapbook = find_scrapbook).nil?
-      return head(:not_found) unless (pathname = calculate_pathname(scrapbook, params[:path])).directory?
-
-      if pathname == scrapbook.pages_pathname
-        prepend_view_path(scrapbook.root)
-        render template: 'pages', locals: {scrapbook: scrapbook, pathname: pathname}
-      else
-        render locals: {scrapbook: scrapbook, pathname: pathname}
-      end
-    end
+    layout -> { false if request.headers.include?('Turbo-Frame') }
 
     def show
       return head(:not_found) if (scrapbook = find_scrapbook).nil?
 
       pathname = calculate_pathname(scrapbook, params[:id])
-      template = params[:id].delete_suffix('.html')
 
-      if !scrapbook_template_exists?(scrapbook, template) && pathname.directory?
-        render 'scrapbook/pages/index', locals: {scrapbook: scrapbook, pathname: pathname}
+      if request.headers['Turbo-Frame']&.start_with?('path_')
+        render partial: 'layouts/scrapbook/folder_listing',
+          locals: {scrapbook: scrapbook, pathname: pathname}
       else
         render locals: {scrapbook: scrapbook, pathname: pathname}, formats: [:html]
       end
@@ -34,13 +24,17 @@ module Scrapbook
       return head(:not_found) if (scrapbook = find_scrapbook).nil?
 
       pathname = calculate_pathname(scrapbook, params[:id])
-      template = params[:id].delete_suffix('.html')
+      template = calculate_template
 
       if scrapbook_template_exists?(scrapbook, template)
-        prepend_view_path(scrapbook.pages_pathname)
+        prepend_view_path(scrapbook.root)
         render template: template,
           locals: {scrapbook: scrapbook, pathname: pathname},
           layout: 'layouts/scrapbook/host_application'
+      elsif pathname.directory?
+        render '/pages',
+          locals: {scrapbook: scrapbook, pathname: pathname},
+          layout: 'layouts/scrapbook/host_application'
       elsif pathname.exist?
         render file: pathname
       else
@@ -51,25 +45,31 @@ module Scrapbook
     private
 
     def find_scrapbook
-      scrapbook_path = if params[:book].present?
-        ::Scrapbook::Engine.config.scrapbook.paths.find { File.basename(_1) == params[:book] }
-      else
-        ::Scrapbook::Engine.config.scrapbook.paths.first
-      end
+      return nil if book_name.blank?
 
+      scrapbook_path = Engine.config.scrapbook.paths[book_name]
       scrapbook_path && Scrapbook.new(scrapbook_path)
     end
 
     def calculate_pathname(scrapbook, path)
-      if path.present?
-        scrapbook.pages_pathname.join(path)
-      else
-        scrapbook.pages_pathname
-      end
+      scrapbook.pages_pathname.join(path || '')
+    end
+
+    def calculate_template
+      return 'pages' if params[:id].blank?
+
+      "pages/#{params[:id].delete_suffix('.html')}"
     end
 
     def scrapbook_template_exists?(scrapbook, template)
-      EmptyController.new.tap { |c| c.prepend_view_path(scrapbook.pages_pathname) }.template_exists?(template)
+      # It's deprecated, but Rails 6 allows for templates to be specified with extensions.
+      return false if Rails.version.to_i == 6 && template.include?('.')
+
+      EmptyController.new.tap { |c| c.prepend_view_path(scrapbook.root) }.template_exists?(template)
+    end
+
+    def book_name
+      params[:'.book']
     end
   end
 end

data/app/helpers/scrapbook/folder_listing_view_model.rb

@@ -3,12 +3,13 @@
 module Scrapbook
   # Model to assest list a folder's contents
   class FolderListingViewModel
-    attr_reader :view, :scrapbook, :pathname, :files, :folders
+    attr_reader :view, :scrapbook, :pathname, :files, :folders, :depth
 
     def initialize(view, scrapbook, pathname)
       self.view = view
       self.scrapbook = scrapbook
       self.pathname = pathname.directory? ? pathname : pathname.dirname
+      self.depth = calculate_depth
       self.folders, self.files = split_files_and_folders
     end
 
@@ -24,12 +25,18 @@ module Scrapbook
     end
 
     def header_name
-      root? ? "/#{scrapbook.name}" : "/#{pathname.basename}/"
+      root? ? scrapbook.name : pathname.basename.to_s
     end
 
     private
 
-    attr_writer :view, :scrapbook, :pathname, :files, :folders
+    attr_writer :view, :scrapbook, :pathname, :files, :folders, :depth
+
+    def calculate_depth
+      return 0 if pathname == scrapbook.pages_pathname
+
+      scrapbook.relative_page_pathname_for(pathname).descend.count
+    end
 
     def split_files_and_folders
       helper = HelperForView.new(view)

data/app/helpers/scrapbook/helper_for_view.rb

@@ -10,12 +10,24 @@ module Scrapbook
 
     def short_path_to(pathname, scrapbook = nil)
       scrapbook ||= Scrapbook.find_scrapbook_for(pathname)
+      view.short_page_path(scrapbook.relative_page_path_for(pathname))
+    end
+
+    def nav_link_for(scrapbook:, pathname:, is_current: false, depth: 0, **kwargs)
+      link_name = pathname == scrapbook.pages_pathname ? scrapbook.name : pathname.basename
+      link_attrs = {
+        data: {'turbo-frame': 'page_content'},
+        class: %w[block w-100],
+        aria: {}
+      }
+      link_attrs[:style] = "padding-left: #{depth}rem;" if depth != 0
+      link_attrs[:aria][:current] = 'page' if is_current
+      link_attrs[:class].concat(Array(kwargs.delete(:class))) if kwargs.include?(:class)
+      link_attrs[:data].merge!(kwargs.delete(:data)) if kwargs.include?(:data)
+      link_attrs[:aria].merge!(kwargs.delete(:aria)) if kwargs.include?(:aria)
+      link_attrs.merge!(kwargs)
 
-      if scrapbook.root == ::Scrapbook::Engine.config.scrapbook.paths.first
-        view.short_page_path(scrapbook.relative_page_path_for(pathname))
-      else
-        view.book_page_path(scrapbook.relative_page_path_for(pathname), book: scrapbook.name)
-      end
+      view.link_to(link_name, short_path_to(pathname, scrapbook), **link_attrs)
     end
 
     def remove_handler_exts_from(pathname)

data/app/models/scrapbook/scrapbook.rb

@@ -9,11 +9,11 @@ module Scrapbook
 
     def self.find_scrapbook_for(pathname)
       scrapbooks = ::Scrapbook::Engine.config.scrapbook.paths
-      candidates = scrapbooks.each_with_index.filter_map do |pname, index|
+      candidates = scrapbooks.filter_map do |book, pname|
         relative_path = pathname.relative_path_from(pname)
         next if relative_path.to_s.start_with?('..')
 
-        [index, relative_path.each_filename.count]
+        [book, relative_path.each_filename.count]
       end
       raise NotFoundError if candidates.empty?
 
@@ -25,7 +25,7 @@ module Scrapbook
     end
 
     def name
-      root.basename
+      root.basename.to_s
     end
 
     def pages_pathname
@@ -43,6 +43,15 @@ module Scrapbook
       relative_path
     end
 
+    def relative_page_pathname_for(pathname)
+      relative_path = pathname.relative_path_from(pages_pathname)
+      if relative_path.to_s.start_with?('..')
+        raise ArgumentError, "Pathname isn't inside the scrapbook pages: #{relative_path}"
+      end
+
+      relative_path
+    end
+
     def ==(other)
       other.class == self.class && other.root == root
     end

data/app/views/layouts/scrapbook/_folder_listing.html.erb

@@ -2,8 +2,29 @@
   helper = Scrapbook::HelperForView.new(self)
   listing = Scrapbook::FolderListingViewModel.new(self, scrapbook, pathname)
   pathname_without_handler_exts = helper.remove_handler_exts_from(pathname)
+  indentation_depth = (local_assigns[:nav_depth] || listing.depth) + 1
+  selection_classes = "active:bg-sky-200 hover:bg-sky-50 [&:has([aria-current=page])]:bg-sky-100"
 %>
-<% unless listing.root? %><%= link_to "‹ #{listing.parent_display_name}", helper.short_path_to(listing.pathname.parent), class: 'back-to-parent block w-100' %><% end %>
-<header aria-label="Which folder's contents" class="text-2xl <%= listing.pathname == pathname ? 'bg-sky-100' : '!px-0 children:px-4' %>"><% if listing.pathname == pathname %><span aria-current="page"><%= listing.header_name %></span><% else %><%= link_to(listing.header_name, helper.short_path_to(listing.pathname), class: 'block w-100') %><% end %></header>
-<ul class="!px-0" aria-label="Sub-folders"><% listing.folders.each do |folder| %><li class="children:px-4"><%= link_to "#{folder.basename}/", helper.short_path_to(folder, scrapbook), class: 'block w-100' %></li><% end %></ul>
-<ul class="!px-0" aria-label="Sub-files"><% listing.files.each do |file| %><% next if listing.folders.include?(file) %><li class="children:px-4"><% if file == pathname_without_handler_exts %><span class="block w-100 bg-sky-100" aria-current="page"><%= file.basename %></span><% else %><%= link_to file.basename, helper.short_path_to(file, scrapbook), class: 'block w-100' %><% end %></li><% end %></ul>
+<% unless listing.root? %><%= link_to "‹ #{listing.parent_display_name}", helper.short_path_to(listing.pathname.parent, scrapbook), class: 'back-to-parent block w-100' %><% end %>
+<header aria-label="Which folder's contents" class="text-2xl !px-0 children:px-4 <%= selection_classes %>">
+  <%= helper.nav_link_for(scrapbook: scrapbook, pathname: listing.pathname, is_current: pathname == listing.pathname) %>
+</header>
+<turbo-frame id="path_<%= pathname.hash %>">
+  <ul aria-label="Sub-folders">
+  <% listing.folders.each do |folder| %>
+    <li>
+      <details>
+        <summary class="flex <%= selection_classes %>" style="padding-left: <%= indentation_depth %>rem;">
+          <%= helper.nav_link_for(scrapbook: scrapbook, pathname: folder, class: 'grow') %>
+        </summary>
+        <turbo-frame id="path_<%= folder.hash %>" src="<%= helper.short_path_to(folder, scrapbook) %>" loading="lazy"></turbo-frame>
+      </details>
+    </li>
+  <% end %>
+  </ul>
+  <ul aria-label="Sub-files">
+  <% listing.files.each do |file| %><% next if listing.folders.include?(file) %>
+    <li class="<%= selection_classes %>"><%= helper.nav_link_for(scrapbook: scrapbook, pathname: file, is_current: file == pathname_without_handler_exts, depth: indentation_depth) %></li>
+  <% end %>
+  </ul>
+</turbo-frame>

data/app/views/layouts/scrapbook/application.html.erb

@@ -1,14 +1,19 @@
 <!DOCTYPE html>
 <html>
 <head>
-  <title><%= local_assigns[:scrapbook].name || 'Scrapbook' %>: <%= content_for?(:title) ? yield(:title) : local_assigns[:pathname].basename %></title>
+  <title><%= local_assigns[:scrapbook]&.name || 'Scrapbook' %>: <%= content_for?(:title) ? yield(:title) : local_assigns[:pathname]&.basename %></title>
   <%= csrf_meta_tags %>
   <%= csp_meta_tag %>
 
   <%= stylesheet_link_tag "scrapbook/application", media: "all", "data-turbo-track": "reload" %>
+  <%= javascript_include_tag "scrapbook/application" %>
+  <meta name="scrapbook-root" content="<%= root_path %>">
 </head>
 <body class="flex">
-  <nav class="flex-none min-w-[20ch] max-w-[50%] h-screen overflow-scroll children:px-4 py-2 border-solid border-sky-700 border-0 border-r"><%= render 'layouts/scrapbook/folder_listing', scrapbook: local_assigns[:scrapbook], pathname: local_assigns[:pathname] %></nav>
+  <nav id="folder_listing" class="flex-none min-w-[20ch] max-w-[50%] h-screen overflow-scroll border-solid border-sky-700 border-0 border-r"><%= render 'layouts/scrapbook/folder_listing', scrapbook: local_assigns[:scrapbook], pathname: local_assigns[:pathname], nav_depth: 0 %></nav>
   <main class="py-2 px-4 h-screen w-screen overflow-scroll"><%= yield %></main>
+  <script type="text/javascript">
+
+  </script>
 </body>
 </html>

data/app/views/pages.html.erb

@@ -1 +1,2 @@
-This directory has no corresponding template. You can add a template named "pages" to the Scrapbook root directory and its contents will show up here.
+<% if pathname == scrapbook.pages_pathname %>This directory has no corresponding template. You can add a template named "pages" to the Scrapbook root directory and its contents will show up here.
+<% else %>This directory has no corresponding template. You can add a template with the same name as the directory as a sibling to the directory and its contents will show up here.<% end %>

data/app/views/scrapbook/pages/show.html.erb

@@ -1 +1,3 @@
-<iframe src="<%= raw_page_path(book: scrapbook.name, id: scrapbook.relative_page_path_for(pathname)) %>" class="w-full h-full"></iframe>
+<turbo-frame id="page_content" class="w-full h-full" data-turbo-action="advance">
+  <iframe src="<%= raw_page_path(scrapbook.relative_page_path_for(pathname)) %>" class="w-full h-full"></iframe>
+</turbo-frame>

data/config/routes.rb

@@ -1,16 +1,13 @@
 # frozen_string_literal: true
 
 Scrapbook::Engine.routes.draw do
-  book_regex = /#{Scrapbook::Engine.config.scrapbook.paths.map { File.basename(_1) }.join('|')}/
+  # TODO: Future plans
+  # scope path: '/.editor' do
+  #   resources :pages, id: /.+/, only: %i[new create edit update]
+  # end
 
-  resources :pages, id: /.+/
-  resources :pages, path: ':book/pages', id: /.+/, constraints: {book: book_regex}
+  root 'pages#show'
 
-  get ':book', to: 'pages#index', constraints: {book: book_regex}
-  root 'pages#index'
-
-  get '.raw/:book/pages/*id', to: 'pages#raw', as: :raw_page,
-    constraints: {book: book_regex, id: /.*/}, defaults: {raw: true}
-  get ':book/*id', to: 'pages#show', constraints: {book: book_regex, id: /.*/}, as: :book_page
+  get '.raw/pages(/*id)', to: 'pages#raw', constraints: {id: /.*/}, as: :raw_page
   get '*id', to: 'pages#show', constraints: {id: /.*/}, as: :short_page
 end

data/lib/generators/scrapbook/install_generator.rb

@@ -5,11 +5,12 @@ require 'rails/generators'
 module Scrapbook
   # Initial default setup of Scrapbook
   class InstallGenerator < Rails::Generators::Base
-    class_option 'url-path', default: '/scrapbook'
     class_option 'path-with-name', default: 'scrapbook'
 
     def install
-      generate 'scrapbook:routes', options.fetch('url-path')
+      name = Pathname.new(options.fetch('path-with-name')).basename.to_s
+
+      generate 'scrapbook:routes', name
       generate 'scrapbook:new', options.fetch('path-with-name')
       sprockets_support
     end
@@ -20,7 +21,8 @@ module Scrapbook
       relative_path = 'app/assets/config/manifest.js'
       return unless FileTest.exist?(File.expand_path(relative_path, destination_root))
 
-      insert_into_file(relative_path, '//= link scrapbook/application.css')
+      insert_into_file(relative_path, "//= link scrapbook/application.css\n")
+      insert_into_file(relative_path, "//= link scrapbook/application.js\n")
     end
   end
 end

data/lib/generators/scrapbook/routes_generator.rb

@@ -3,19 +3,21 @@
 require 'rails/generators'
 
 module Scrapbook
-  # A generator to create a new scrapbook at either the default (scrapbook) or specified
-  # path from the Rails application root.
+  # A generator to create a new scrapbook with  either the default (scrapbook) or specified
+  # name. (Using the default options for the URL path and folder root.)
   class RoutesGenerator < Rails::Generators::Base
-    argument :path, optional: true, default: '/scrapbook'
+    argument :name, optional: true, default: 'scrapbook'
 
     def routes
       # TODO: Investigate using a Rubocop rule to determine using single or double auotes.
-      url_path = path.start_with?('/') ? path : "/#{path}"
-      route <<~ROUTES
-        if Rails.env.development?
-          mount Scrapbook::Engine => '#{url_path}'
-        end
-      ROUTES
+
+      inject_into_file('config/routes.rb', after: "Rails.application.routes.draw do\n") do
+        "  extend Scrapbook::Routing\n"
+      end
+
+      inject_into_file('config/routes.rb', after: "extend Scrapbook::Routing\n") do
+        "\n  scrapbook('#{name}') if Rails.env.development?\n"
+      end
     end
   end
 end

data/lib/scrapbook/engine.rb

@@ -6,20 +6,12 @@ module Scrapbook
     isolate_namespace Scrapbook
 
     config.scrapbook = ActiveSupport::OrderedOptions.new
-    config.scrapbook.paths ||= []
+    config.scrapbook.paths ||= {}
     config.scrapbook.precompile_assets = config.scrapbook.precompile_assets || false
 
-    initializer 'scrapbook.configuration' do |app|
-      settings = app.config.scrapbook
-
-      settings.paths << Rails.root.join('scrapbook') if settings.paths.empty?
-    end
-
     initializer 'scrapbook.assets' do |app|
       if app.config.scrapbook.precompile_assets && app.config.respond_to?(:assets)
-        app.config.assets.precompile.concat %w[
-          scrapbook/application.css
-        ]
+        app.config.assets.precompile.push('scrapbook/application.css')
       end
     end
   end

data/lib/scrapbook/routing.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Scrapbook
+  # This is a helper method for making it easier to add scrapbooks to routes.
+  module Routing
+    def scrapbook(name, at: "/#{name}", folder_root: name)
+      folder_root = Pathname.new(folder_root)
+      folder_root = Rails.root.join(folder_root) if folder_root.relative?
+
+      Engine.config.scrapbook.paths[name] = folder_root
+      mount Engine => at, defaults: {'.book': name}, as: "#{name}_scrapbook"
+    end
+  end
+end

data/lib/scrapbook/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Scrapbook
-  VERSION = '0.2.1'
+  VERSION = '0.3.0'
 end

data/lib/scrapbook.rb

@@ -2,6 +2,7 @@
 
 require 'scrapbook/version'
 require 'scrapbook/engine'
+require 'scrapbook/routing'
 
 # TODO: Figure out documentation
 # Placeholder

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: scrapbook
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Brad Lindsay
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-08-14 00:00:00.000000000 Z
+date: 2023-06-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '6.1'
     - - "<"
       - !ruby/object:Gem::Version
         version: '7.1'
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '6.1'
     - - "<"
       - !ruby/object:Gem::Version
         version: '7.1'
@@ -43,6 +43,7 @@ files:
 - Rakefile
 - app/assets/builds/scrapbook/application.css
 - app/assets/config/scrapbook_manifest.js
+- app/assets/javascripts/scrapbook/application.js
 - app/assets/stylesheets/scrapbook/application.tailwind.css
 - app/controllers/scrapbook/application_controller.rb
 - app/controllers/scrapbook/empty_controller.rb
@@ -50,13 +51,11 @@ files:
 - app/helpers/scrapbook/application_helper.rb
 - app/helpers/scrapbook/folder_listing_view_model.rb
 - app/helpers/scrapbook/helper_for_view.rb
-- app/mailers/scrapbook/application_mailer.rb
 - app/models/scrapbook/scrapbook.rb
 - app/views/layouts/scrapbook/_folder_listing.html.erb
 - app/views/layouts/scrapbook/application.html.erb
 - app/views/layouts/scrapbook/host_application.html.erb
 - app/views/pages.html.erb
-- app/views/scrapbook/pages/index.html.erb
 - app/views/scrapbook/pages/show.html.erb
 - config/routes.rb
 - lib/generators/scrapbook/install_generator.rb
@@ -64,6 +63,7 @@ files:
 - lib/generators/scrapbook/routes_generator.rb
 - lib/scrapbook.rb
 - lib/scrapbook/engine.rb
+- lib/scrapbook/routing.rb
 - lib/scrapbook/version.rb
 - lib/tasks/scrapbook_tasks.rake
 homepage: https://bfad.github.io/scrapbook

data/app/mailers/scrapbook/application_mailer.rb

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-
-module Scrapbook
-  class ApplicationMailer < ActionMailer::Base
-    default from: 'from@example.com'
-    layout 'mailer'
-  end
-end

data/app/views/scrapbook/pages/index.html.erb

@@ -1 +0,0 @@
-This directory has no corresponding template. You can add a template with the same name as the directory as a sibling to the directory and its contents will show up here.