[IMP] web, web_editor, website: small refactoring of LESS files

This commit comments some LESS files to help the user to understand
for what their content is used (preparing the LESS editor feature).

1 files changed, 22 insertions, 44 deletions

diff --git a/addons/web_editor/static/src/less/web_editor.common.less b/addons/web_editor/static/src/less/web_editor.common.less
index c4ebd1ce900..c48fdf7df46 100644
--- a/addons/web_editor/static/src/less/web_editor.common.less
+++ b/addons/web_editor/static/src/less/web_editor.common.less
@@ -1,22 +1,21 @@
+///
+/// This file regroups basic style rules for web_editor enable page edition and backend utils.
+///
+
 html, body {
     width: 100%;
     height: 100%;
 }
 
-/* ----- EDITOR ----- */
 .css_non_editable_mode_hidden {
     display: none !important;
 }
-
 .editor_enable .css_editable_mode_hidden {
-  display: none !important;
+    display: none !important;
 }
-
-/* ----- Editor (for public user, like forum) ----- */
 .note-toolbar {
     margin-left: 0 !important;
 }
-
 .note-popover .popover > .arrow {
     display: none;
 }
@@ -37,11 +36,10 @@ html, body {
     }
 }
 
-/* Media */
+// Medias
 img.shadow {
     box-shadow: 0px 3px 8px rgba(0, 0, 0, 0.2);
 }
-
 img.padding-small, .img.padding-small, span.fa.padding-small, iframe.padding-small {
     padding: 4px;
 }
@@ -55,47 +53,25 @@ img.padding-xl, .img.padding-xl, span.fa.padding-xl, iframe.padding-xl {
     padding: 32px;
 }
 
-div.media_iframe_video {
-    &.padding-small iframe {
-        padding: 4px;
-    }
-    &.padding-medium iframe {
-        padding: 8px;
-    }
-    &.padding-large iframe {
-        padding: 16px;
-    }
-    &.padding-xl iframe {
-        padding: 32px;
-    }
-}
-
-/* font awsome */
 .fa-6x {
     font-size: 6em;
 }
-
 .fa-7x {
     font-size: 7em;
 }
-
 .fa-8x {
     font-size: 8em;
 }
-
 .fa-9x {
     font-size: 9em;
 }
-
 .fa-10x {
     font-size: 10em;
 }
-
 .fa.center-block {
     text-align: center;
 }
 
-/* video */
 div.media_iframe_video {
     margin: 0 auto;
     text-align: center;
@@ -109,6 +85,18 @@ div.media_iframe_video {
         margin: 0 auto;
         margin-left: -50%;
     }
+    &.padding-small iframe {
+        padding: 4px;
+    }
+    &.padding-medium iframe {
+        padding: 8px;
+    }
+    &.padding-large iframe {
+        padding: 16px;
+    }
+    &.padding-xl iframe {
+        padding: 32px;
+    }
 
     .media_iframe_video_size {
         padding-bottom: 66.5%;
@@ -130,7 +118,6 @@ html[data-browser^="msie"] div.media_iframe_video iframe {
     margin-left: 0;
 }
 
-/* Mobile view */
 @media (max-width: @screen-xs-max) {
     img:not(.cke_iframe), .media_iframe_video, span.fa, i.fa {
         -webkit-transform: none !important;
@@ -141,7 +128,7 @@ html[data-browser^="msie"] div.media_iframe_video iframe {
     }
 }
 
-/* ---- fields --- */
+// Fields
 address {
     .fa.fa-mobile-phone {
         margin: 0 3px 0 2px;
@@ -155,12 +142,8 @@ span[data-oe-type="monetary"] {
     white-space: nowrap;
 }
 
-/* ---- MENU ---- {{{ */
-div.oe_menu_buttons {
-    top: -8px;
-    right: -8px;
-}
-
+// Menus
+// TODO should not be here but used by web_studio so must stay here for now
 ul.oe_menu_editor {
     .fa-home {
         display: none;
@@ -177,11 +160,6 @@ ul.oe_menu_editor {
     li div {
         cursor: move;
     }
-    .disclose {
-        cursor: pointer;
-        width: 10px;
-        display: none;
-    }
 }
 
 // Generate all margins for all sizes
@@ -251,7 +229,7 @@ a.o_underline {
 @color-delta: #0D6759;
 @color-epsilon: #0B2E59;
 
-//Greyscale transparent colours
+// Greyscale transparent colours
 @color-black-25: fade(black, 25%);
 @color-black-50: fade(black, 50%);
 @color-black-75: fade(black, 75%);