From 2d4a3ec910b94aaeb663ec50f9883acfab669e99 Mon Sep 17 00:00:00 2001 From: Victor Losada Hernandez Date: Sat, 22 Apr 2023 15:30:22 +0200 Subject: [PATCH] landing page update --- client/homebrew/pages/homePage/welcome_msg.md | 65 ++++++++++--------- 1 file changed, 35 insertions(+), 30 deletions(-) diff --git a/client/homebrew/pages/homePage/welcome_msg.md b/client/homebrew/pages/homePage/welcome_msg.md index 3332dfc39..f8721c5cb 100644 --- a/client/homebrew/pages/homePage/welcome_msg.md +++ b/client/homebrew/pages/homePage/welcome_msg.md @@ -6,7 +6,6 @@ padding-bottom : 1.1cm; } ``` - # The Homebrewery *V3* Welcome traveler from an antique land. Please sit and tell us of what you have seen. The unheard of monsters, who slither and bite. Tell us of the wondrous items and and artifacts you have found, their mysteries yet to be unlocked. Of the vexing vocations and surprising skills you have seen. @@ -18,7 +17,7 @@ The Homebrewery makes the creation and sharing of authentic looking Fifth-Editio ### Editing and Sharing When you create your own homebrew, you will be given a *edit url* and a *share url*. -Any changes you make while on the *edit url* will be automatically saved to the database within a few seconds. Anyone with the edit url will be able to make edits to your homebrew, so be careful about who you share it with. +Any changes you make while on the *edit url* will be automatically saved to the database within a few seconds. No one can edit your brew even if you share the edit link, unless you add them as an author via the {{fa,fa-info-circle}} **Properties** tab. Anyone with the *share url* will be able to access a read-only version of your homebrew. @@ -48,57 +47,62 @@ If you want to save ink or have a monochrome printer, add the **PRINT → {{fas, \column -## New in V3.0.0 -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. No raw HTML tags should be needed in a brew (*but can still be used if you insist*). +## V3 vs Legacy +The Homebrewery has two renderers: Legacy and V3. The V3 renderer is recommended and will receive updates, while the Legacy renderer will not. Legacy mode is still available for older brews and veteran users, but won't be updated. +: +V3 uses curly brackets instead of HTML tags, though HTML tags can still be used. Converting between Legacy and V3 may require tweaking the document. However, all legacy brews will still render normally. Both renderers can be accessed via the {{fa,fa-info-circle}} **Properties** button on your brew at any time. -Much of the syntax and styling has changed in V3, so converting a Legacy brew to V3 (or vice-versa) will require tweaking your document. *However*, 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 at any time. - -Scroll down to the next page for a brief summary of the changes and new features available in V3! +Scroll down to the next page for a brief summary of the changes and features available in V3! #### New Things All The Time! Check out the latest updates in the full changelog [here](/changelog). ### Helping out -Like this tool? Want to buy me a beer? [Head here](https://www.patreon.com/Naturalcrit) to help me keep the servers running. +Like this tool? Want to buy us a beer? [Head here](https://www.patreon.com/Naturalcrit) to help us keep the servers running. -This tool will **always** be free, never have ads, and I will never offer any "premium" features or whatever. +This tool will **always** be free, never have ads, and we will never offer any "premium" features or whatever. ### Bugs, Issues, Suggestions? -Take a quick look at our [Frequently Asked Questions page](/faq) to see if your question has a handy answer. - -Need help getting started or just the right look for your brew? Head to [r/Homebrewery](https://www.reddit.com/r/homebrewery/submit?selftext=true&title=%5BIssue%5D%20Describe%20Your%20Issue%20Here) and let us know! - -Have an idea to make The Homebrewery better? Or did you find something that wasn't quite right? Check out the [GitHub Repo](https://github.com/naturalcrit/homebrewery/) to report technical issues. +- Check the [Frequently Asked Questions](/faq) page first for quick answers. +- Get help or the right look for your brew by posting on [r/Homebrewery](https://www.reddit.com/r/homebrewery/submit?selftext=true&title=%5BIssue%5D%20Describe%20Your%20Issue%20Here) or joining the [Discord Of Many Things](https://discord.gg/by3deKx). +- Report technical issues or provide feedback on the [GitHub Repo](https://github.com/naturalcrit/homebrewery/). ### Legal Junk The Homebrewery is licensed using the [MIT License](https://github.com/naturalcrit/homebrewery/blob/master/license). Which means you are free to use The Homebrewery codebase any way that you want, except for claiming that you made it yourself. If you wish to sell or in some way gain profit for what's created on this site, it's your responsibility to ensure you have the proper licenses/rights for any images or resources used. - -#### Crediting Me -If you'd like to credit me in your brew, I'd be flattered! Just reference that you made it with The Homebrewery. +#### Crediting Us +If you'd like to credit us in your brew, we'd be flattered! Just reference that you made it with The Homebrewery. ### More Homebrew Resources -Discord of Many Things Logo -If you are looking for more 5e Homebrew resources check out [r/UnearthedArcana](https://www.reddit.com/r/UnearthedArcana/) and their list of useful resources [here](https://www.reddit.com/r/UnearthedArcana/wiki/resources). The Discord of Many Things is another great resource to connect with fellow homebrewers for help and feedback. +[![Discord](/assets/discordOfManyThings.svg){width:50px,float:right,padding-left:10px}](https://discord.gg/by3deKx) + +If you are looking for more 5e Homebrew resources check out [r/UnearthedArcana](https://www.reddit.com/r/UnearthedArcana/) and their list of useful resources [here](https://www.reddit.com/r/UnearthedArcana/wiki/resources). The [Discord Of Many Things](https://discord.gg/by3deKx) is another great resource to connect with fellow homebrewers for help and feedback. + {{position:absolute;top:20px;right:20px;width:auto - - - - +[![Discord](/assets/discord.png){height:30px}](https://discord.gg/by3deKx) +[![Github](/assets/github.png){height:30px}](https://github.com/naturalcrit/homebrewery) +[![Patreon](/assets/patreon.png){height:30px}](https://patreon.com/NaturalCrit) +[![Reddit](/assets/reddit.png){height:30px}](https://www.reddit.com/r/homebrewery/) }} \page + + + + + + + ## Markdown+ The Homebrewery aims to make homebrewing as simple as possible, providing a live editor with Markdown syntax that is more human-readable and faster to write with than raw HTML. -In version 3.0.0, with a goal of adding maximum flexibility without users resorting to complex HTML to accomplish simple tasks, Homebrewery provides an extended verision of Markdown with additional syntax. -**You can enable V3 via the {{fa,fa-info-circle}} Properties button!** +From version 3.0.0, with a goal of adding maximum flexibility without users resorting to complex HTML to accomplish simple tasks, Homebrewery provides an extended verision of Markdown with additional syntax. ### Curly Brackets -The biggest change in V3 is the replacement of `` and `
` with `{{ }}` for a cleaner custom formatting. Inline spans and block elements can be created and given ID's and Classes, as well as css properties, each of which are comma separated with no spaces. Use double quotes if a value requires spaces. Spans and Blocks start the same: +Markdown is a simplified version of HTML, as such there are equivalences like the replacement of `` and `
` with `{{ }}` for a cleaner custom formatting. Inline spans and block elements can be created and given ID's and Classes, as well as css properties, each of which are comma separated with no spaces. Use double quotes if a value requires spaces. Spans and Blocks start the same: #### Span My favorite author is {{pen,#author,color:orange,font-family:"trebuchet ms" Brandon Sanderson}}. The orange text has a class of `pen`, an id of `author`, is colored orange, and given a new font. The first space outside of quotes marks the beginning of the content. @@ -126,16 +130,17 @@ A blank line can be achieved with a run of one or more `:` alone on a line. More :: + Much nicer than `




` ### Definition Lists **Example** :: V3 uses HTML *definition lists* to create "lists" with hanging indents. + + ### Column Breaks Column and page breaks with `\column` and `\page`. -\column - ### Tables Tables now allow column & row spanning between cells. This is included in some updated snippets, but a simplified example is given below. @@ -163,13 +168,13 @@ Using *Curly Injection* you can assign an id, classes, or inline CSS properties ![alt-text](https://s-media-cache-ak0.pinimg.com/736x/4a/81/79/4a8179462cfdf39054a418efd4cb743e.jpg) {width:100px,border:"2px solid",border-radius:10px} -\* *When using Imgur-hosted images, use the "direct link", which can be found when you click into your image in the Imgur interace.* +\* *When using Imgur-hosted images, use the "direct link", which can be found when you click into your image in the Imgur interface.* ## Snippets Homebrewery comes with a series of *code snippets* found at the top of the editor pane that make it easy to create brews as quickly as possible. Just set your cursor where you want the code to appear in the editor pane, choose a snippet, and make the adjustments you need. ## 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 `