From 494311aee3079106a46311dc0cf41f190c443ea9 Mon Sep 17 00:00:00 2001 From: Trevor Buckner Date: Fri, 10 Sep 2021 00:13:48 -0400 Subject: [PATCH 1/4] Popup notification Update the popup notification on the home page. --- .../notificationPopup/notificationPopup.jsx | 41 ++++++++++++++----- .../notificationPopup/notificationPopup.less | 16 ++++---- 2 files changed, 39 insertions(+), 18 deletions(-) diff --git a/client/homebrew/brewRenderer/notificationPopup/notificationPopup.jsx b/client/homebrew/brewRenderer/notificationPopup/notificationPopup.jsx index f561298a3..9bfea7ff0 100644 --- a/client/homebrew/brewRenderer/notificationPopup/notificationPopup.jsx +++ b/client/homebrew/brewRenderer/notificationPopup/notificationPopup.jsx @@ -4,7 +4,7 @@ const createClass = require('create-react-class'); const _ = require('lodash'); const cx = require('classnames'); //Unused variable -const DISMISS_KEY = 'dismiss_notification7-10-20'; +const DISMISS_KEY = 'dismiss_notification09-9-21'; const NotificationPopup = createClass({ getInitialState : function() { @@ -22,16 +22,33 @@ const NotificationPopup = createClass({ notifications : { psa : function(){ return
  • - Google Drive Integration!
    - We have added Google Drive integration to the Homebrewery! Sign in with - your Google account to link it with your Homebrewery profile. A new button in the Edit page will let you transfer your file to your personal - Google Drive storage, and Google will keep a backup of each version! No more lost work surprises! + V3.0.0 Released!
    + After a long and bumpy road, we decided it was high time we finally release version 3 of the homebrewery into the wild. You can check out a + brief overview and see how to opt-in to the new features here:   + V3 Welcome Page   + and the Changelog.

    - However, we are aware that there may be uncaught bugs. We encourage you to copy your brew into a text document before transferring to Google - Drive just in case any issues arise as this update is rolled out. + BE WARNED: As we continue to develop V3, expect small tweaks in the styling, fonts, and snippets; your brews may look slightly + different from day-to-day. All of your old documents will continue to work as normal; we are not touching them. If you don't want to deal + with the possibility of slight formatting changes, you may choose to stick with the Legacy renderer on any of your brews for as long as you like.

    - Note: Transferring an existing brew to Google Drive will change the edit and share links of your document. If you have shared your - document online, remember to update the links there as well. + With this in mind, if you still wish to try out V3, you can opt-in any of your brews to the the V3 renderer. + This will likely break much of your formatting as a lot of the Markdown code has been updated, and starting from scratch may be cleaner. + (Don't worry, you can always change the renderer back to legacy for any brew at any time). +
    • ; + }, + refreshGoogle : function (){ + return
  • + Refresh your Google Drive Credentials!
    + Currently a lot of people are striking issues with their Google credentials expiring, which happens one year after the last sign in via + Google. This can cause errors when trying to save your brews. If this happens, simply visit the   + + logout page + + , sign out, and then sign back in "with Google" to refresh your credentials. See   + + this discussion on Github + for more details.
    • ; }, faq : function(){ @@ -62,8 +79,10 @@ const NotificationPopup = createClass({ return
    -

    Notice

    - This website is always improving and we are still adding new features and squashing bugs. Keep the following in mind: +
    +

    Notice

    + This website is always improving and we are still adding new features and squashing bugs. Keep the following in mind: +
      {_.values(this.state.notifications)}
    ; } diff --git a/client/homebrew/brewRenderer/notificationPopup/notificationPopup.less b/client/homebrew/brewRenderer/notificationPopup/notificationPopup.less index 69bffd583..dfd3c6c63 100644 --- a/client/homebrew/brewRenderer/notificationPopup/notificationPopup.less +++ b/client/homebrew/brewRenderer/notificationPopup/notificationPopup.less @@ -1,23 +1,22 @@ .popups{ position : fixed; - top : @navbarHeight; + top : @navbarHeight; right : 15px; z-index : 10001; - width : 350px; + width : 450px; } .notificationPopup{ - position : relative; - float : right; + position : relative; display : inline-block; - width : 350px; + width : 100%; padding : 15px; padding-bottom : 10px; - padding-left : 55px; + padding-left : 25px; background-color : @blue; color : white; a{ - color : @steel; + color : #e0e5c1; font-weight : 800; } i.info{ @@ -37,6 +36,9 @@ opacity : 1; } } + .header { + padding-left : 50px; + } small{ opacity : 0.7; font-size : 0.6em; From 2497fbbc7405b861fe368567389fdd9b254b6947 Mon Sep 17 00:00:00 2001 From: Trevor Buckner Date: Fri, 10 Sep 2021 23:22:52 -0400 Subject: [PATCH 2/4] Tweaks to popup notification. --- .../notificationPopup/notificationPopup.jsx | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/client/homebrew/brewRenderer/notificationPopup/notificationPopup.jsx b/client/homebrew/brewRenderer/notificationPopup/notificationPopup.jsx index 9bfea7ff0..819bf53d3 100644 --- a/client/homebrew/brewRenderer/notificationPopup/notificationPopup.jsx +++ b/client/homebrew/brewRenderer/notificationPopup/notificationPopup.jsx @@ -24,9 +24,9 @@ const NotificationPopup = createClass({ return
  • V3.0.0 Released!
    After a long and bumpy road, we decided it was high time we finally release version 3 of the homebrewery into the wild. You can check out a - brief overview and see how to opt-in to the new features here:   - V3 Welcome Page   - and the Changelog. + brief overview and see how to opt-in to the new features here:  + V3 Welcome Page and  + the Changelog.

    BE WARNED: As we continue to develop V3, expect small tweaks in the styling, fonts, and snippets; your brews may look slightly different from day-to-day. All of your old documents will continue to work as normal; we are not touching them. If you don't want to deal @@ -34,18 +34,18 @@ const NotificationPopup = createClass({

    With this in mind, if you still wish to try out V3, you can opt-in any of your brews to the the V3 renderer. This will likely break much of your formatting as a lot of the Markdown code has been updated, and starting from scratch may be cleaner. - (Don't worry, you can always change the renderer back to legacy for any brew at any time). + (Don't worry, you can always change the renderer back to Legacy for any brew at any time).
    • ; }, refreshGoogle : function (){ return
  • Refresh your Google Drive Credentials!
    Currently a lot of people are striking issues with their Google credentials expiring, which happens one year after the last sign in via - Google. This can cause errors when trying to save your brews. If this happens, simply visit the   + Google. This can cause errors when trying to save your brews. If this happens, simply visit the  logout page - , sign out, and then sign back in "with Google" to refresh your credentials. See   + , sign out, and then sign back in "with Google" to refresh your credentials. See  this discussion on Github for more details. @@ -54,7 +54,7 @@ const NotificationPopup = createClass({ faq : function(){ return
  • Protect your work!
    - If you opt not to use your Google Drive, keep in mind that we do not save a history of your projects. Please make frequent backups of your brews!   + If you opt not to use your Google Drive, keep in mind that we do not save a history of your projects. Please make frequent backups of your brews!  See the FAQ to learn how to avoid losing your work! From 6237df953ef396308752c5f8700813202fc2701d Mon Sep 17 00:00:00 2001 From: Trevor Buckner Date: Fri, 10 Sep 2021 23:34:20 -0400 Subject: [PATCH 3/4] Update changelog and welcome pages --- changelog.md | 181 ++++++++++++++++++ client/homebrew/pages/homePage/welcome_msg.md | 12 +- .../homebrew/pages/homePage/welcome_msg_v3.md | 18 +- 3 files changed, 191 insertions(+), 20 deletions(-) diff --git a/changelog.md b/changelog.md index cde71bb57..fb1d3c538 100644 --- a/changelog.md +++ b/changelog.md @@ -32,6 +32,187 @@ pre { # changelog +### Saturday, 28/08/2021 - v3.0.0 + +We have been working on v3 for a *very* long time. We want to thank everyone for being paitent. + + +Some features planned for V3 have actually been released over the recent months as part of V2, and some are still on the way. But at its core, V3 provides brand new Markdown-to-Brew rendering system, which was no simple task. This has opened up access to all sorts of bugfixes, tweaks, and potential for new features that just wouldn't be possible on the old system. + +***BE WARNED:*** As we continue to develop V3, expect small tweaks in the styling, fonts, and snippets; your brews may look slightly different from day-to-day; some things might break completely while we tackle any bugs in this early stage. All of your old documents will continue to work as normal. We are not touching them. If you don't want to deal With the possibility of slight formatting changes, you may choose to stick with the Legacy renderer on any of your brews for as long as you like. However, most new features added from now on will only be available for brews using the V3 renderer. + +Massive changelog incoming: + +#### Markdown+ +With the latest major update to *The Homebrewery*, we've implemented an extended Markdown-like syntax for block and span elements, plus a few other changes, eliminating the need for HTML tags like `div`, and `span` in most cases. This should hopefully aid non-coders with readability, and also allows us a few tricks in the background to fix some old issues. No raw HTML tags should be needed in a brew, and going forward, raw HTML will no longer receive debugging support (*but can still be used if you insist*). + +All brews made prior to the release of v3.0.0 will still render normally, and you may switch between the "Legacy" brew renderer and the newer "V3" renderer via the {{fa,fa-info-circle}} **Properties** button on your brew. Much of the syntax and styling has changed in V3, so code in one version may be broken in the other. + +Visit [this page](/v3_preview) for brief examples of the new syntax! + +#### Extended Markdown Syntax: + +{{taskList +* [x] Add Divs and Spans for all your custom styling needs, via a simplified Markdown-like syntax: + ``` + {{myDivClass,#myId,color:red + My Div content + }} + + Hello {{mySpan,color:blue World}} ! + ``` + Fixes issues: [#348](https://github.com/naturalcrit/homebrewery/issues/348) + +* [x] Add inline CSS to Markdown objects via "curly injection" syntax: + ``` + Hello *world*{myClass,#id,color:red} + ``` + Fixes issues: [#403](https://github.com/naturalcrit/homebrewery/issues/403) +}} + +\column + +{{taskList +* [x] Rowspan, Colspan, and multiple header rows with extended table syntax: +``` +| Header 1a | Header 1b | Header 1c | +| Header 2a | Header 2b | Header 2c | +|:---------:|:----------|:---------:| +| Span 2 columns || Span 2 | +| one col | one col | rows ^| +``` + Fixes issues: [#773](https://github.com/naturalcrit/homebrewery/issues/773), [#191](https://github.com/naturalcrit/homebrewery/issues/191) + +* [x] Hanging indents via `
    ` tags, as seen in the **PHB → Spell** snippet. Add via "double-colon" syntax: +``` +Term :: big long definition that bleeds onto multiple lines +``` + Fixes issues: [#182](https://github.com/naturalcrit/homebrewery/issues/182), [#149](https://github.com/naturalcrit/homebrewery/issues/149) + +* [x] Easier vertical spacing via colons alone on a line: + ``` + ::: + ``` + Fixes issues: [#374](https://github.com/naturalcrit/homebrewery/issues/374) + +* [x] Avoid paragraph indendation by ending the previous paragraph with a backslash `\` or two spaces ` ` + ``` + Paragraph one\ + Paragraph two + ``` + Fixes issues: [#636](https://github.com/naturalcrit/homebrewery/issues/636) + +* [x] Code blocks can be inserted by surrounding it with rows of three backticks ` ``` `, for demonstration purposes or to share custom styles. Inline-code can be inserted with single backticks `code` + 
    ```
+ Here is some code!
+```
+
    + + Fixes issues: [#465](https://github.com/naturalcrit/homebrewery/issues/465) + +#### New and Fixed Snippets + +* [x] Column breaks now use `\column` instead of ` ``` ` backticks. + + Fixes issues: [#607](https://github.com/naturalcrit/homebrewery/issues/607) + +* [x] Page breaks using `\page` now only trigger when placed alone at the start of a line. + + Fixes issues: [#1147](https://github.com/naturalcrit/homebrewery/issues/1147) + +* [x] New **EDITOR → QR Code** snippet. + + Fixes issues: [#538](https://github.com/naturalcrit/homebrewery/issues/538) + +* [x] New **IMAGES → Watercolor Splatter** snippet, which adds one of a range of stylish stains to your brew. + +* [x] New **IMAGES → Watermark** snippet, which adds transparent text diagonally across the page. + +* [x] New **PHB → Magic Item** snippet. + + Fixes issues: [#671](https://github.com/naturalcrit/homebrewery/issues/671) + +* [x] New **TABLES → 1/3 Class Table** snippet for 1/3 casters. + + Fixes issues: [#191](https://github.com/naturalcrit/homebrewery/issues/191) +}} + +\page +{{taskList +* [x] Improved **EDITOR → Table of Contents** snippet to actually look like the PHB style. Will auto-generate based on the headers in your brew. + + Fixes issues: [#304](https://github.com/naturalcrit/homebrewery/issues/304) + +* [x] Improved **PHB → Monster Stat Block** snippet with textures, and an option to remove the frame entirely. + +* [x] Improved **PHB → Spell List** snippet can now be made single-column. + + Fixes issues: [#509](https://github.com/naturalcrit/homebrewery/issues/509), [#914](https://github.com/naturalcrit/homebrewery/issues/914) + +* [x] Improved **TABLES → Class Table** snippet is now cleaned up, has an option to remove the frame entirely, and includes additional boundary decorations. + + Fixes issues: [#773](https://github.com/naturalcrit/homebrewery/issues/773), [#302](https://github.com/naturalcrit/homebrewery/issues/302) + +#### Miscellaneous Formatting Fixes + +* [x] Paragraphs are now able to split across columns. + + Fixes issues: [#239](https://github.com/naturalcrit/homebrewery/issues/239) + +* [x] Multiple fixes for bold/italicize using asterisks `* *` + + Fixes issues: [#1321](https://github.com/naturalcrit/homebrewery/issues/1321), [#852](https://github.com/naturalcrit/homebrewery/issues/852) + +* [x] Multiple for list items not displaying correctly. + + Fixes issues: [#1085](https://github.com/naturalcrit/homebrewery/issues/1085), [#588](https://github.com/naturalcrit/homebrewery/issues/588) + +* [x] "Smart quotes", so left and right quotes are different. + + Fixes issues: [#849](https://github.com/naturalcrit/homebrewery/issues/849) + +* [x] Long URLs in links now wrap properly. + + Fixes issues: [#1136](https://github.com/naturalcrit/homebrewery/issues/1136) + +* [x] Better support for `wide` blocks that span across the whole page! No more problems with contents getting shunted off the edge, and each new wide element in a page will restart the next item back at column one. Manual `\column` breaks will help organize subsequent content between the columns as needed. + + Fixes issues: [#144](https://github.com/naturalcrit/homebrewery/issues/144), [#1024](https://github.com/naturalcrit/homebrewery/issues/1024) + +* [x] Fonts now support a wider range of latin characters for non-English brews, including áéíóúñ¡¿, etc... + + Fixes issues: [#116](https://github.com/naturalcrit/homebrewery/issues/116) + +* [x] Drop-caps (fancy first letters) have been re-styled and re-aligned to correct the ugly overlapping and cut-off on some characters like K and Y. + + Fixes issues: [#848](https://github.com/naturalcrit/homebrewery/issues/848) +}} + +\column + +### Under-the-Hood Stuff +We had to make a whole lot of background upgrades and changes to get all of this working, and now that the framework is in place, there's a lot more planned and upcoming *"sometime"* : + +{{taskList +* [ ] New Themes to style your brews. DMG, MM, a custom Homebrewery theme, and others. +* [ ] The ability to build your own custom themes using CSS, apply it to other brews, and share it with others! +* [ ] Easy control of item colors. Change your monster blocks, tables, and notes from yellow to green to red! +* [ ] New image-based snippets, including handwritten notes, title illustrations, and alternative decorations. +* [ ] New fun fonts like Elvish, Draconic, Orcish, etc. +* [ ] Better organization of personal brews using tags. +* [ ] ....a log-out button...? +* [ ] AND MORE. +}} + +### Interface +:: +#### Style Editor Panel + +{{fa,fa-paint-brush}} Technically released prior to v3 but still new to many users, check out the new **Style Editor** located on the right side of the Snippet bar. This editor accepts CSS for styling without requiring `