Ghost/ghost/admin/app
Kevin Ansfield 3653cfbfbf Refactored document-title handler
no issue
- moved `document-title` Route extension's functionality into the `ui` service
  - updates the title each time the router service emits a route changed event
  - `ui.updateDocumentTitle()` can now be called directly from components rather than the confusing `this.send('updateDocumentTitle')` bubbling behaviour
- refactored the `titleToken` implementation to use the now-formalised `RouteInfo`'s `metadata` field (https://github.com/emberjs/rfcs/blob/master/text/0398-RouteInfo-Metadata.md#appendix-a)
2019-05-20 16:16:19 +01:00
..
adapters Removed use of ?include=tags,authors,authors.roles query param on post/page requests 2019-02-25 21:55:55 +07:00
authenticators Use Admin API v2 with session auth (#1046) 2018-10-05 19:46:33 +01:00
components Fixed gh-search-input tests failing on Ember 3.10 2019-05-20 11:32:08 +01:00
controllers Refactored document-title handler 2019-05-20 16:16:19 +01:00
helpers Removed usage of ember-light-table in subscribers screen (#1191) 2019-05-07 12:39:56 +01:00
initializers Bumped dependencies (Fixed production build) (#1091) 2019-01-08 12:36:16 +00:00
mixins Refactored styleBody mixin 2019-05-20 14:57:21 +01:00
models Updated member management data (#1150) 2019-04-16 20:32:43 +05:30
routes Refactored document-title handler 2019-05-20 16:16:19 +01:00
serializers 🐛 Fixed error when creating subscribers via the admin area 2019-03-06 09:19:39 +00:00
services Refactored document-title handler 2019-05-20 16:16:19 +01:00
session-stores Use Admin API v2 with session auth (#1046) 2018-10-05 19:46:33 +01:00
styles Refactored styleBody mixin 2019-05-20 14:57:21 +01:00
templates Added ability to set <main> class using route metadata 2019-05-20 15:33:12 +01:00
transforms Updated member management data (#1150) 2019-04-16 20:32:43 +05:30
transitions Fixed autofocus not working on modal inputs 2018-06-04 17:48:57 +01:00
utils Refactored document-title handler 2019-05-20 16:16:19 +01:00
validators Added ability to override the canonical URL of posts/pages 2019-03-12 10:40:07 +00:00
app.js Removed unnecessary TextField override 2019-02-11 13:51:10 +00:00
index.html 🤡 Serve own admin favicon (#619) 2017-04-06 17:28:51 +01:00
README.md Convert Sass to Myth 2015-05-22 19:05:09 +01:00
resolver.js deps: ember-cli@2.3.0 2016-02-16 12:32:48 -06:00
router.js Refactored document-title handler 2019-05-20 16:16:19 +01:00
transitions.js Unsplash integration 2017-08-15 16:01:12 +01:00

Ghost Admin Client

Ember.js application used as a client-side admin for the Ghost blogging platform. This readme is a work in progress guide aimed at explaining the specific nuances of the Ghost Ember app to contributors whose main focus is on this side of things.

CSS

We use pure CSS, which is pre-processed for backwards compatibility by Myth. We do not follow any strict CSS framework, however our general style is pretty similar to BEM.

Styles are primarily broken up into 4 main categories:

  • Patterns - are base level visual styles for HTML elements (eg. Buttons)
  • Components - are groups of patterns used to create a UI component (eg. Modals)
  • Layouts - are groups of components used to create application screens (eg. Settings)

All of these separate files are subsequently imported and compiled in app.css.

Front End Standards

  • 4 spaces for HTML & CSS indentation. Never tabs.
  • Double quotes only, never single quotes.
  • Use tags and elements appropriate for an HTML5 doctype (including self-closing tags)
  • Adhere to the Recess CSS property order.
  • Always a space after a property's colon (.e.g, display: block; and not display:block;).
  • End all lines with a semi-colon.
  • For multiple, comma-separated selectors, place each selector on its own line.
  • Use js- prefixed classes for JavaScript hooks into the DOM, and never use these in CSS as per Slightly Obtrusive JavaSript
  • Avoid over-nesting CSS. Never nest more than 3 levels deep.
  • Use comments to explain "why" not "what" (Good: This requires a z-index in order to appear above mobile navigation. Bad: This is a thing which is always on top!)