Skip to content
Snippets Groups Projects
Commit e2ff9050 authored by chris's avatar chris
Browse files

note container in progress

parent cee3939b
No related branches found
No related tags found
1 merge request!57Develop
Hide whitespace changes
Inline Side-by-side
README.md deleted 100644 → 0
+ 0
− 386
View file @ cee3939b
<div width="100%" align="center">
<h1>Wax Editor</h1>
</div>
| [![MIT license](https://img.shields.io/badge/license-MIT-e51879.svg)](https://gitlab.coko.foundation/wax/wax-prosemirror/raw/master/LICENSE) [![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/) |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
This application is being developed by the [Coko Foundation](https://coko.foundation/), for the [University of California Press](http://www.ucpress.edu/) as part of the [Editoria](https://gitlab.coko.foundation/editoria/editoria/) application.
Wax Editor is build against Prosemirror libraries. Check Prosemirror [website](https://prosemirror.net/) and [GitHub repo](https://github.com/ProseMirror) for more information.
## Get up and running
Run a local version of the editor
1. `git@gitlab.coko.foundation:wax/wax-prosemirror.git`
2. `yarn with node > 11`
3. `yarn editoria` Will bring up a demo of the Editoria Ediitor
Scripts: `yarn` , `yarn clean`, `yarn reset`
## Introduction
Wax depends on the following libraries.
* React for the view(ui)
* Styled-components for theming and styling.
* Inversify.io as service containers
### Assemble your own Editor
Currently Wax is under heavy development. Master holds a as possible as stable version of the editor. As we are prioritizing on the configuration of the editor and having most features working up to
a good extend with minimal work done on UI , expect features to not cover all uses cases/or not work 100% as expected.
Check editoria [editor](https://gitlab.coko.foundation/wax/wax-prosemirror/blob/master/editors/editoria/src/Editoria.js), editoria's [package.json](https://gitlab.coko.foundation/wax/wax-prosemirror/blob/master/editors/editoria/package.json)
and editoria's [configuration file](https://gitlab.coko.foundation/wax/wax-prosemirror/blob/master/editors/editoria/src/config/config.js) for a full example on how to mount Wax and all available packages(services).
### Editor Properties
All available editor properties
```javascript
autoFocus; // sets cursor in the begging of the document
onChange; // when the editor's surface is updated (perform an action ex. save)
value; // the actual HTML content of the editor
fileUpload; // used for uploading images (should return a promise with the actual file path)
placeholder; // a placeholder used for empty documents
config; // adds on the editor anything from new services, tools, Pmpplugins etc. Check [editoria config](https://gitlab.coko.foundation/wax/wax-prosemirror/blob/master/editors/editoria/src/config/config.js)
TrackChange; // Enable track changes
readonly; // editor in in read-only mode
onBlur; // on focus lost
layout; // used to create your own Layout using React components
```
**Current Tools and Toolgroups:**
1. _Base Tool group_: `undo`, `redo`, `save`
2. _Inline Annotations Tool group_: `strong`, `italic`, `link`, `strikethrough`, `underline`, `subscript`, `superscript`, `small caps`
3. _Lists Tool group_: `numbered list`, `bullet list`
4. _Image Tool group_: `image`
5. _Table Tool group_: `create table`, edit table dropdown that includes: `insert/delete row`, `insert/delete column` ,`merge cells`, `split cell`, `delete table`, `Toggle header column`, `Toggle header row`
6. _Display Tool group_: `Title`, `Author`, `Subtitle`, `Epigraph Prose`, `Epigraph Poetry`, `Heading 1`, `Heading 2`, `Heading 3`
7. _Text Tool group_: `Paragraph`, `Paragraph Continued`, `Extract Prose`, `Extract Poetry`, `Source Note`, `Block Quote`
8. _Notes Tool group_: `notes` (currently under development)
<h2> wax-prosemirror-core </h2>
The role of wax-core is
* Mount a prosemirror instance
* Initiate default services ([link](https://gitlab.coko.foundation/wax/wax-prosemirror/blob/master/wax-prosemirror-core/src/config/defaultConfig.js))
1. LayoutService
2. SchemaService
3. MenuService
4. RulesService
5. ShortCutsService
A big part of wax-core is the [application layer](https://gitlab.coko.foundation/wax/wax-prosemirror/blob/master/wax-prosemirror-core/src/Application.js), which is responsible for the application’s lifecycle by registering and booting services, merging configs, using the schema
and gathering all prosemirror plugins.
Also holds some default prosemirror plugins that are necessary like the dropCursor, gapCursor, history and some optional as the placeholder.
<h2> wax-prosemirror-schema </h2>
Holds all the nodes and marks currently supported by Wax. You can either have a node/mark in “Wax node/mark structure” or a default prosemirror node/mark.
For more information on how a Wax node/mark is different check the [SchemaService](#schemaservice)
<h2> wax-prosemirror-components </h2>
React components to support various features of the editor from buttons to overlays to comment discussions etc. Right now is really basic as the focus is not yet on UI.
<h2> wax-prosemirror-themes </h2>
Holds the different themes of the editor. Check the options in the [CokoTheme](https://gitlab.coko.foundation/wax/wax-prosemirror/tree/master/wax-prosemirror-themes/src/coko-theme)
<h2> wax-prosemirror-layouts </h2>
Holds different layouts of the editor. Through the layout service you can configure the areas of different components (as an example check [EditoriaLayout](https://gitlab.coko.foundation/wax/wax-prosemirror/blob/master/wax-prosemirror-layouts/src/layouts/EditoriaLayout.js))
<h2> wax-prosemirror-utilities </h2>
Various helpers methods needed throughout Wax to support the funcionality needed.
<h2> Editors </h2>
Editors are private pakages inside the monorepo, for development/demo purposes.
<h2> wax-prosemirror-services</h2>
Service providers are the central place of Wax bootstrapping. Your own services, as well as all of Wax's core services are bootstrapped via application provider and are initiated before everything else.
But, what do we mean by "bootstrapped"? In general, we mean registering things, including registering service container bindings and event listeners. Service providers are the central place to configure your application.
If you open [editoria's config file](https://gitlab.coko.foundation/wax/wax-prosemirror/tree/master/editors/editoria/src/config/config.js),
you will see the config file where you can configure the extra services (apart from those Wax will load on init) of your editor.
These are all of the service provider classes that will be loaded for your application.
In the following overview we will see how to write our own service providers and register them within the Editor.
<h3>Writing Service Providers</h2>
All service providers extend the [Service](https://gitlab.coko.foundation/wax/wax-prosemirror/tree/master/wax-prosemirror-core/src/services/Service.js) class. Most service providers contain a register and a boot method. Within the register method, you should only bind things into the service container.
<h3>The Register Method</h3>
Let’s take a look at a simple service like the StrongService. Within any of your service provider methods, you always have access to the config and schema properties and also you have access to the service container using [inversify.io](http://inversify.io/).
```javascript
import { toggleMark } from "prosemirror-commands";
import Service from "wax-prosemirror-core/src/services/Service";
import { strongMark } from "wax-prosemirror-schema";
import Strong from "./Strong";
class StrongService extends Service {
boot() {
const shortCuts = this.container.get("ShortCuts");
shortCuts.addShortCut({ "Mod-b": toggleMark(this.schema.marks.strong) });
}
register() {
this.container.bind("Strong").to(Strong);
const createMark = this.container.get("CreateMark");
createMark(
{
strong: strongMark
},
{ toWaxSchema: true }
);
}
}
export default StrongService;
```
This service provider defines a register method, it registers a class and in this case is the strong tool. For more information on how to use service container check inversify.io documentation.
A slightly more complicated example could be the ShortCutsService register method.
```javascript
register() {
const PmPlugins = this.app.PmPlugins;
this.container
.bind("ShortCuts")
.toDynamicValue(() => {
const { schema: { schema } } = this.app;
return new ShortCuts(PmPlugins, schema);
})
.inSingletonScope();
}
```
In the above example we bind ShortCuts to a factory method which injects PmPlugins and schema into ShortCuts class.
### The Boot Method
So, what if we need to register a view component within our service provider? This should be done within the boot method. This method is called after all other service providers have been registered, meaning you have access to all other services that have been registered.
In the StrongService when the boot method is called all other services will have been registered, so we get the ShortCuts Service and execute a method for registering a new ShortCut.
Another example could be the MenuSerivce (link)
```javascript
boot() {
const { menus } = this.container.get("MenuCollection");
const layout = this.container.get("Layout");
menus.forEach(menu => {
layout.addComponent(menu.config.templateArea, menu.render());
});
}
```
In Menu’s boot method we get Layout and we add components to the already defined areas from our Layout.
### Extra functionalities include
1. Registering Services from within a Service.
```javascript
class InlineAnnotationsService extends Service {
dependencies = [
new CodeService(),
new StrongService(),
new EmphasisService(),
new SubscriptService(),
new SuperscriptService(),
new StrikeThroughService(),
new UnderlineService(),
new SmallCapsService()
];
}
```
2. Within any of your service provider methods, you always have access to the app, config properties .
3. Dependant functionality between services. An example of the dependency between two services is linkService(link) and OverLayService (links) where OverLayService registers a function
that adds a component to the overlay area and LinkService calls OverLay and adds it’s component. ShortCut Service could be another example where each of the services like Strong, paragraph etc can call it to add a shortcut.
## Core Services
### SchemaService
Schema service enable us to add marks and nodes into prosemirror. We have two functions for that scope CreateNode and CreateMark.
In prosemirror all attributes are in the node so you might have on the same node a class , href, user attribute etc. This attributes might be used from different services.
So for example on the pararaph node Service A adds the class attribute while Service B adds the user attribute.
If you only use Service A the user attribute still exists in the schema for that node.
So if we want to add the user attribute only through service B , we have “toWaxSchema” option .
Service A register method.
```javascript
CreateNode(
{
paragraph: {
group: "block",
content: "inline*",
attrs: {
class: { default: "paragraph" }
},
parseDOM: {
tag: "p.paragraph",
getAttrs(hook, next) {
Object.assign(hook, {
class: hook.dom.getAttribute("class")
});
next();
}
},
toDOM(hook, next) {
const attrs = { class: hook.node.attrs.class };
hook.value = ["p", attrs, 0];
next();
}
}
},
{ toWaxSchema: true }
);
```
Service B register method.
```javascript
CreateNode(
{
paragraph: {
group: "block",
content: "inline*",
attrs: {
user: { default: [] }
},
parseDOM: {
tag: "p.paragraph",
getAttrs(hook, next) {
Object.assign(hook, {
user: parseUser(hook.dom.dataset.user)
});
next();
}
},
toDOM(hook, next) {
Object.assign(hook.value[1], {
"data-user": JSON.stringify(hook.node.attrs.user)
});
next();
}
}
},
{ toWaxSchema: true }
);
```
If the above 2 services are registed SchemaService will merge those 2 nodes into a single prosemirror one having both attributes.
LayoutService
This service enables us to set a layout for the editor. Internally Wax calls the setLayout method to apply a layout. How can you write your own layout. (link editoria layout).
A layout is a react component which has a prop the mounted prosemirror instance in order to place within the layout. You can also have your own “Areas”. For example in EditoriaLayout we have the following
```javascript
const LeftSideBar = componentPlugin("leftSideBar");
const RightSideBar = componentPlugin("rightSideBar");
const TopBar = componentPlugin("topBar");
const BottomBar = componentPlugin("bottomBar");
const WaxOverlays = componentPlugin("waxOverlays");
const EditoriaLayout = ({ editor }) => {
return (
<ThemeProvider theme={cokoTheme}>
<LayoutWrapper>
<MainMenuContainer>
<MainMenuInner>
<TopBar />
</MainMenuInner>
</MainMenuContainer>
<WaxSurfaceContainer>
<SideMenuContainer>
<SideMenuInner>
<LeftSideBar />
</SideMenuInner>
</SideMenuContainer>
<WaxSurfaceScroll className="wax-surface-scroll">
{editor}
<WaxOverlays />
</WaxSurfaceScroll>
<RightSideBar />
</WaxSurfaceContainer>
<BottomBar />
<InfoArea />
</LayoutWrapper>
</ThemeProvider>
);
};
```
`<LeftSideBar />` is placed accordingly to our design in the left of the editor as ui element.
So we define a “leftSideBar” area. Area is like a “tag” for the editor so it knows where to place certain components. So by defining the leftSideBar Area we can use that area in our services to add components into it.
An example of using areas in editoria config.
```javascript
MenuService: [
{
templateArea: "topBar",
toolGroups: ["Base", "Annotations", "Lists", "Images", "Tables"]
},
{
templateArea: "leftSideBar",
toolGroups: ["Display"]
}
],
```
Lastly Layout has a core method which is called ComponentPlugin. Is used in order to render the components to the area and to provide the view state of the editor in order to get updates.
### ShortCuts Service
Another Core Service of Wax for registering shortcuts within a service. Check as an example , how it is used on Strong [Service](https://gitlab.coko.foundation/wax/wax-prosemirror/blob/master/wax-prosemirror-services/src/InlineAnnotations/StrongService/StrongService.js).
### Rules Service
Core Service of Wax for registering prosemirror rules. Check editoria [config](https://gitlab.coko.foundation/wax/wax-prosemirror/blob/master/wax-prosemirror-core/src/config/defaultConfig.js) or it can be used
from within any service similar to Short Cuts as an `addRule` method is available.
### Menu Service
Is used for adding menus to the editor. **TO DO How to create a group/tool and add it to the menu.**
## Other Stuff
1. How to create overlays
wax-prosemirror-components/index.js
+ 3
− 0
View file @ e2ff9050
......@@ -8,3 +8,6 @@ export { default as LeftMenuTitle } from "./src/components/LeftMenuTitle";
export {
default as ToolGroupComponent
} from "./src/components/ToolGroupComponent";
export {
default as NoteEditorContainer
} from "./src/components/notes/NoteEditorContainer";
wax-prosemirror-components/src/components/notes/NoteEditorContainer.js 0 → 100644
+ 16
− 0
View file @ e2ff9050
import React, { useRef } from "react";
import styled from "styled-components";
const NoteEditorContainerStyled = styled.div`
height: 100px;
${"" /* width: 65%;*/} ${"" /* margin-left: 17%;*/}
border: 1px solid black;
`;
const NoteEditorContainer = ({ ref }) => {
console.log(ref);
const editorRef = useRef();
return <NoteEditorContainerStyled ref={editorRef} />;
};
export default NoteEditorContainer;
wax-prosemirror-services/src/NoteService/Editor.js
+ 7
− 1
View file @ e2ff9050
......@@ -6,6 +6,7 @@ import { keymap } from "prosemirror-keymap";
import { undo, redo } from "prosemirror-history";
import { WaxContext } from "wax-prosemirror-core/src/ioc-react";
import { Commands } from "wax-prosemirror-utilities";
import { NoteEditorContainer } from "wax-prosemirror-components";
export default ({ node, view, pos }) => {
const editorRef = useRef();
......@@ -84,7 +85,12 @@ export default ({ node, view, pos }) => {
return (
<div
style={{ height: "100px", border: "1px solid black" }}
style={{
height: "50px",
width: "61%",
"margin-left": "14%",
border: "1px solid black"
}}
ref={editorRef}
/>
);
......
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment