From fb33e58e837b1d94823d727d5d688f227a4e68f4 Mon Sep 17 00:00:00 2001
From: Artur Arseniev <artur.catch@hotmail.it>
Date: Thu, 12 Jul 2018 00:03:18 +0200
Subject: [PATCH] Refactor demos in docs

---
 .../.vuepress/components/DemoCustomPanels.vue | 18 ++++--
 docs/.vuepress/components/DemoLayers.vue      | 28 +++------
 .../.vuepress/components/demos/DemoLayers.css | 17 +++++
 docs/.vuepress/components/demos/utils.js      | 11 ++--
 docs/getting-started.md                       | 63 ++++++++++---------
 5 files changed, 82 insertions(+), 55 deletions(-)
 create mode 100644 docs/.vuepress/components/demos/DemoLayers.css

diff --git a/docs/.vuepress/components/DemoCustomPanels.vue b/docs/.vuepress/components/DemoCustomPanels.vue
index 3359116f3..e21be23ab 100644
--- a/docs/.vuepress/components/DemoCustomPanels.vue
+++ b/docs/.vuepress/components/DemoCustomPanels.vue
@@ -1,6 +1,8 @@
 <template>
   <div>
-    <div class="basic-panel" id="basic-panel3"></div>
+    <div class="panel__top" id="panel__top3">
+        <div class="panel__basic-actions" id="panel__basic-actions3"></div>
+    </div>
     <div class="gjs" id="gjs3">
       <h1>Hello World Component!</h1>
     </div>
@@ -13,8 +15,11 @@ module.exports = {
   mounted() {
     const utils = require('./demos/utils.js');
     const editor3 = grapesjs.init(utils.gjsConfigPanels);
-    editor3.Panels.addPanel(Object.assign({}, utils.customPanel, {
-      el: '#basic-panel3'
+    editor3.Panels.addPanel(Object.assign({}, utils.panelTop, {
+      el: '#panel__top3'
+    }));
+    editor3.Panels.addPanel(Object.assign({}, utils.panelBasicActions, {
+      el: '#panel__basic-actions3'
     }));
     window.editor3 = editor3;
   }
@@ -22,10 +27,15 @@ module.exports = {
 </script>
 
 <style>
-  .basic-panel {
+  .panel__top {
+    padding: 0;
     width: 100%;
     display: flex;
+    position: initial;
     justify-content: center;
+    justify-content: space-between;
+  }
+  .panel__basic-actions {
     position: initial;
   }
   .content pre {
diff --git a/docs/.vuepress/components/DemoLayers.vue b/docs/.vuepress/components/DemoLayers.vue
index 964b25ef9..f07658acd 100644
--- a/docs/.vuepress/components/DemoLayers.vue
+++ b/docs/.vuepress/components/DemoLayers.vue
@@ -1,6 +1,8 @@
 <template>
   <div>
-    <div class="basic-panel" id="basic-panel4"></div>
+    <div class="panel__top" id="panel__top4">
+        <div class="panel__basic-actions" id="panel__basic-actions4"></div>
+    </div>
 
     <div class="editor-row">
       <div class="editor-canvas">
@@ -8,7 +10,7 @@
           <h1>Hello World Component!</h1>
         </div>
       </div>
-      <div class="editor-sidebar" id="editor-sidebar">
+      <div class="panel__right" id="panel__right4">
         <div id="layers-container"></div>
       </div>
     </div>
@@ -22,26 +24,16 @@ module.exports = {
   mounted() {
     const utils = require('./demos/utils.js');
     const editor4 = grapesjs.init(utils.gjsConfigLayers);
-    editor4.Panels.addPanel(Object.assign({}, utils.customPanel, {
-      el: '#basic-panel4'
+    editor4.Panels.addPanel(Object.assign({}, utils.panelTop, {
+      el: '#panel__top4'
+    }));
+    editor4.Panels.addPanel(Object.assign({}, utils.panelBasicActions, {
+      el: '#panel__basic-actions4'
     }));
     window.editor4 = editor4;
   }
 }
 </script>
 
-<style>
-.editor-row {
-  display: flex;
-  justify-content: flex-start;
-  align-items: stretch;
-  flex-wrap: nowrap;
-}
-.editor-canvas {
-  flex-grow: 1;
-}
-.editor-sidebar {
-  flex-basis: 230px;
-  position: relative;
-}
+<style src="./demos/DemoLayers.css">
 </style>
diff --git a/docs/.vuepress/components/demos/DemoLayers.css b/docs/.vuepress/components/demos/DemoLayers.css
new file mode 100644
index 000000000..85808c3c8
--- /dev/null
+++ b/docs/.vuepress/components/demos/DemoLayers.css
@@ -0,0 +1,17 @@
+.editor-row {
+  display: flex;
+  justify-content: flex-start;
+  align-items: stretch;
+  flex-wrap: nowrap;
+  height: 300px;
+}
+
+.editor-canvas {
+  flex-grow: 1;
+}
+
+.panel__right {
+  flex-basis: 230px;
+  position: relative;
+  overflow-y: auto;
+}
diff --git a/docs/.vuepress/components/demos/utils.js b/docs/.vuepress/components/demos/utils.js
index 673ba99ee..9ccee893a 100644
--- a/docs/.vuepress/components/demos/utils.js
+++ b/docs/.vuepress/components/demos/utils.js
@@ -29,8 +29,9 @@ var blockManager = {
   ]
 };
 
-var customPanel = {
-  id: 'custom-panel',
+var panelTop = { id: 'panel-top' };
+var panelBasicActions = {
+  id: 'panel-basic',
   buttons: [
     {
       id: 'visibility',
@@ -61,9 +62,8 @@ var customPanel = {
     }
   ],
 };
-
 var panelSidebar = {
-  el: '#editor-sidebar',
+  el: '#panel__right4',
   id: 'layers',
   // Make the panel resizable
   resizable: {
@@ -116,5 +116,6 @@ module.exports = {
   gjsConfigBlocks,
   gjsConfigPanels,
   gjsConfigLayers,
-  customPanel,
+  panelTop,
+  panelBasicActions,
 };
diff --git a/docs/getting-started.md b/docs/getting-started.md
index a92683eed..664d04a44 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -35,7 +35,7 @@ With just the canvas you're already able to move, copy and delete components fro
 ## Add Blocks
 The block in GrapesJS is just a reusable piece of HTML that you can drop in the canvas. A block can be an image, a button, or an entire section with videos, forms and iframes. Let's start from creating another container and append inside it few basic blocks which we can later use to build more complex structures.
 
-```html
+```html{4}
 <div id="gjs">
   ...
 </div>
@@ -144,18 +144,38 @@ myComponent.components('<div>New content</div>');
 ## Panels & Buttons
 Now that we have a canvas and custom blocks let's see how to create a new custom panel with some buttons inside (using [Panels API](api/panels.html)) which trigger commands (the core one or custom).
 
-```html
-<div id="basic-panel"></div>
+```html{1,2,3}
+<div class="panel__top">
+    <div class="panel__basic-actions"></div>
+</div>
 <div id="gjs">
   ...
 </div>
 <div id="blocks"></div>
 ```
 
+```css
+.panel__top {
+  padding: 0;
+  width: 100%;
+  display: flex;
+  position: initial;
+  justify-content: center;
+  justify-content: space-between;
+}
+.panel__basic-actions {
+  position: initial;
+}
+```
+
 ```js
 editor.Panels.addPanel({
-  id: 'custom-panel',
-  el: '#basic-panel',
+  id: 'panel-top',
+  el: '.panel__top',
+});
+editor.Panels.addPanel({
+  id: 'basic-actions',
+  el: '.panel__basic-actions',
   buttons: [
     {
       id: 'visibility',
@@ -206,46 +226,33 @@ editor.on('abort:export-template', () => console.log('Command aborted'));
 ## Layers
 Another utility tool you might find useful when working with web elements is a layer manger. It's just a tree overview of the structure nodes and enables you to manage it easier. To enable it you just have to specify where you want to render it
 
-```html
-<div id="basic-panel"></div>
+```html{4,5,6,7,8,9,10,11}
+<div class="panel__top">
+    <div class="panel__basic-actions"></div>
+</div>
 <div class="editor-row">
   <div class="editor-canvas">
     <div id="gjs">...</div>
   </div>
-  <div class="editor-sidebar">
-    <div id="layers-container"></div>
+  <div class="panel__right">
+    <div class="layers-container"></div>
   </div>
 </div>
 <div id="blocks"></div>
 ```
-
-```css
-.editor-row {
-  display: flex;
-  justify-content: flex-start;
-  align-items: stretch;
-  flex-wrap: nowrap;
-}
-.editor-canvas {
-  flex-grow: 1;
-}
-.editor-sidebar {
-  flex-basis: 230px;
-  position: relative;
-}
-```
+<<< @/docs/.vuepress/components/demos/DemoLayers.css
 
 ```js
 const editor = grapesjs.init({
   // ...
   layerManager: {
-    appendTo: '#layers-container'
+    appendTo: '.layers-container'
   },
   // We define a default panel as a sidebar to contain layers
   panels: {
     defaults: [{
       id: 'layers',
-      el: '.editor-sidebar',
+      el: '.panel__right',
       // Make the panel resizable
       resizable: {
         maxDim: 350,
@@ -268,7 +275,7 @@ const editor = grapesjs.init({
 
 ## Style Manager
 An important step in any web project is the style definition and with the built-in style manager module you're able to do it easily and quickly.
-The style manager is composed by style properties and grouped by sectors, so let's see how to define a basic set of them.
+The style manager is composed by style properties and are grouped by sectors, let's see how to define a basic set of them.
 
 -- show how to render SM and show style for width, height, padding, Typography, shadows