alexeysachkov/homebrewery

Create authentic looking D&D homebrews using only markdown

homebrewery's Issues

[Interface] Mark old brew with special badge

v3 contains 2 different brew editors: one for the old version (with html), and another one for new version (without html).

I guess, we would like to remove the old one someday and we need to warn users about it: all old brews should be updated to use new syntax.

I propose the following policy to migrating to the new editor and syntax:

• First stage. Both version are supported. All new brews using new syntax only, no way to switch back.
  All old brews can be edited and marked with old/deprecated/should be updated badge.
  New button added to editor to change brews version and switch editor. Switching to the new version is permanent and cannot be undone.
• Second stage. All old brews are now read-only. User can copy source-code if need, but he cannot change it until brew is not promoted to the new version.
• Third stage. Drop old renderer at all. This is dangerous step: I'm sure that there are a lot of brews created some time ago, shared with community and forgotten by their authors.
  I think that it is possible to account all old brews and implement third stage only when number of old brews is small enough (or all of them are not popular/not shared/etc)

Cleanup .less files

There are a lot of commented code. Need to remove it

[Brew editor] Fix code highlighting for new syntax

a: ``` monster
##### Monster name
**Stat1**: value1
**Stat2**: value2

Some description
b: ```

Lines a and b should be highlighted, but all lines between should be highlighted as normal markdown-code, not as content of code block

[Style presets] Implement style preset for D&D 4E

It is impossible to log in into local version of Homebrewery

This issue blocks v3 version local developments because I can't see admin interface to test changes

[Style presets] Make sure style preset swithcer is working

• Need to check that selected style preset is saved on server after changing.
• To fix: rendered brew is not updated when style preset is changed in metadata editor

[Brew editor] Improve code highlighting for nested code blocks

Markdown fenced code-blocks are used to represent containers, which may be nested.

Each pair of opening/closing fence should be highlighted with different color. For example:

a: `` block
b: `` nested-block
content
c: ``
d: ``

Lines a and d should be highlighted with color1, lines b and c should be highlighted with color2.

Something like this:

[Dependencies] Need to analyse usages of classNames package

Package https://github.com/JedWatson/classnames is listed in package.json as dependency.

As I can see, it is not used much (or I just haven't found such places yet): need to find all usages and estimate usefulness of this package:

• need to remove if there are not so much uses and all could be replace with pure js
• need to leave it as is, but use it often

[Dependcencies] Need to try different ways of loadsh loading

Loadsh is available as per method packages. Need to analyze all usages of it and try to replace the whole package with per-method packages.

Which questions I would like to answer by this investigation:

• will per-method packages reduce bundle size?
• anything else?

This issue is a part of #5

[Dependencies] Analyze dependencies and submit new issues if necessary

I'm not familiar with all of these node.js packages and the hombrewery internals, but I hope that we can reduce number of dependencies.

At least need to analyze all dependencies to get more understanding, update some if necessary and reduce total number of dependencies (more than 650 currently)

[Docs & examples] Need to update welcome brew

Welcome brew should be updated to represent latest updates, new syntax and features

[Docs & Examples] Need to write 'Advanced usage' guide

The purpose of the guide is to describe advanced techniques like nested code-blocks, node attributes, etc