Name: Aether
Sandbox Location: http://drupal.org/sandbox/KrisBulman/1460814
Demo: http://aetherdev.bulman.ca/
Documentation: https://github.com/krisbulman/aether/wiki
Drupal core version: 7.x
Git Branch Version: 7.x-1.x

git clone --recursive --branch 7.x-1.x KrisBulman@git.drupal.org:sandbox/KrisBulman/1460814.git aether

Aether

Introduction to Aether:

Aether is geared towards a themer that utilizes sass/compass, it also aims to provide theme settings for tasks better handled on the Drupal theme layer, such as grid column sizes per region AND per device width.

Aether is a base theme (like zen is), and it provides a subtheme (startertheme) with all the components you should need to build a fixed-width responsive site using re-usable CSS patterns, it supports (out of the box) Handheld Portrait (320px), Handheld Landscape, Tablet Landscape, Tablet Portrait, & Desktop (1140px).

Aether has some cool grid features, handy sass variables/mixins/functions and the ability to add new sass extensions to build on your theme. It is context/delta friendly.

Requirements:

  • Compass 12.1
  • Sass 3.2

Features:

  • HTML5 & CSS3
  • RTL support
  • A unique responsive fixed width grid system (see demo and resize page)
  • 12 column grid
  • Compatible with IE6+ (using Selectivizr as a js shim)
  • Looks good out of the box, AND provides a strong base for sub-themes
  • Attention to vertical rhythm
  • Grid debugging overlay (powered by Compass)
  • Theme settings for sidebar locations and widths
  • All the necessary components for responsive design (responsive out the box)
  • Useful compass mixins for tasks such as button creation, link styling, tabs, etc
  • Useful sass variables for quick theme changes (colors, grid widths, etc)
  • Optional javascript necessary for responsive design, such as html5shiv (local), Respond.js (CDN), Selectivizr (CDN) & imagesizr.js (local), responsive-tables.js (local)

Extensions:

  • Recommended download and inclusion of the iOS-Orientationchange-Fix, OR the drupal module waiting to become a full project here: http://drupal.org/sandbox/utneon/1590218
  • Coupled with Delta & Context, this theme is very powerful, providing different configurable theme settings for any page of your site
  • Sass/Compass support: Installing Compass is a breeze, this theme is powered heavily by compass so it's a must have if you want the most out of this theme. be sure to use --pre when installing compass & sass to get the bleeding edge releases

Known Issues:

  • If Respond.js is enabled, CSS must be aggregated in order for it to work. This is because of Drupal's @import method for CSS files
  • Aether is currently responsive from the desktop down, in the future it may also support 320 and up
  • Currently, only one grid system is available: 12 columns. More support for may come depending on the demand (6, 16 and 24 columns)
  • There is a limit in the theme to using all 5 device widths, or 1 (the default). In future versions, there will be an option to expand to more, or a selective few.

What this theme will never do:

  • Compile Sass. Compass/Sass should be installed in your dev/staging environment.

Support:

  • Currently D7 only, but there may be a D6 back port

A note on 3rd party JS:
The JS listed as included here is linked via CDN, or approved as whitelist code. Inclusion of the HTML5 shim is following John Albin's lead (and the discussion of core inclusion in d8). responsive-tables.js and imgsizr.js are non-licensed projects, and I will modify & maintain the source in Aether.

Reviews of other projects

Display Suite Custom Node Layouts
* http://drupal.org/node/1632730#comment-6118986
iOSZoomFix
* http://drupal.org/node/1590252#comment-6110286
Unactivated User
* http://drupal.org/node/1635610#comment-6119986

CKGeshi
http://drupal.org/node/1627738#comment-6120170
Webform Classes
http://drupal.org/node/1641630#comment-6134572
Search Modify
http://drupal.org/node/1637712#comment-6134620

CommentFileSizeAuthor
#10 aether.txt116.68 KBcarlhinton
#2 errors.txt146.73 KBmuneer1st

Comments

KrisBulman’s picture

Status: Active » Needs review
KrisBulman’s picture

Issue summary: View changes

added demo

KrisBulman’s picture

Issue summary: View changes

moved details

KrisBulman’s picture

Issue summary: View changes

updated included JS note

KrisBulman’s picture

Issue summary: View changes

updated js note

KrisBulman’s picture

Issue summary: View changes

updating js note

KrisBulman’s picture

Issue summary: View changes

updating js notes

KrisBulman’s picture

Issue summary: View changes

updated JS notes

KrisBulman’s picture

Issue summary: View changes

updated js note

KrisBulman’s picture

Issue summary: View changes

updated JS note

KrisBulman’s picture

Issue summary: View changes

updated demo link

KrisBulman’s picture

Issue summary: View changes

added powered by compass

KrisBulman’s picture

Issue summary: View changes

updated git branch version

KrisBulman’s picture

Issue summary: View changes

added g

muneer1st’s picture

Status: Needs review » Needs work
StatusFileSize
new146.73 KB

There are multiple errors in the code.

* README.txt is missing, see the guidelines for in-project documentation.
* Remove LICENSE.txt, it will be added by drupal.org packaging automatically.
* Run coder to check your style, some issues were found (please check the Drupal coding standards). See attachment.
* Drupal Code Sniffer has found some issues with your code (please check the Drupal coding standards). See attachment.

Refer to the attached file

KrisBulman’s picture

Status: Needs work » Needs review

Thanks, done.

* README.txt is missing, see the guidelines for in-project documentation.
* Remove LICENSE.txt, it will be added by drupal.org packaging automatically.
* Run coder to check your style, some issues were found (please check the Drupal coding standards). See attachment.
* Drupal Code Sniffer has found some issues with your code (please check the Drupal coding standards). See attachment.

Also removed unneeded template, which will cause errors until theme-registry is cleared.

KrisBulman’s picture

Issue summary: View changes

removed details tag

KrisBulman’s picture

Status: Needs review » Needs work

Hold on this, broke head while doing some updates.. will switch to review after problems cleared up

KrisBulman’s picture

Status: Needs work » Needs review

resolved problems with commit 88713ca46799b7802d3995f3cab3688992af3845

Latest pull of 7.x-1.x has the latest code for review if anyone can get to it.

KrisBulman’s picture

Issue summary: View changes

updated notes

KrisBulman’s picture

Issue summary: View changes

updated intro

KrisBulman’s picture

Issue summary: View changes

updated links

KrisBulman’s picture

Issue summary: View changes

Documentation Link

anwar_max’s picture

There are still files other than README.txt in the master branch, make sure to remove them. See also step 5 in http://drupal.org/node/1127732
Review of the 7.x-1.x branch:

This automated report was generated with PAReview.sh, your friendly project application review script. You can also use the online version to check your project. You have to get a review bonus to get a review from me.

KrisBulman’s picture

Readme.txt (and no other files on master branch) is now in line with Drupal standards, thanks for catching that.

I have re-run Coder, Codesniffer and PAReview online, there are a few strict errors that show up of which I believe should not affect the promotion to a full project, such as alphabetically ordered css, which is sometimes unavoidable when using a sass compiler for css.

KrisBulman’s picture

Issue summary: View changes

formatting

KrisBulman’s picture

Issue summary: View changes

added note to description

KrisBulman’s picture

Issue summary: View changes

adding links for review bonus

KrisBulman’s picture

Issue tags: +PAreview: review bonus

adding review bonus tag

KrisBulman’s picture

Issue summary: View changes

added review

carlhinton’s picture

Assigned: Unassigned » carlhinton
carlhinton’s picture

StatusFileSize
new116.68 KB

Needs more work, see attached ventral report

carlhinton’s picture

Assigned: carlhinton » Unassigned
Status: Needs review » Needs work
KrisBulman’s picture

thanks

Jeff Burnz’s picture

- redundant code in the user category template.
- format c will not return the right time stamp for pubdate, see #1183250: Add a theme_datetime() function to consistently theme dates and datetimes

There's some talk here about the CSS formatting - however this theme uses SASS so these should be accepted - focus should be on the SASS files and forget about the actual generated CSS - the SASS compiler handles that and is very hard to change certain things - it would be onerous to expect theme developers to manually change the compiled CSS files.

KrisBulman’s picture

Status: Needs work » Needs review

Thanks Jeff,

I cleared those two problems up promptly, the user-category-profile by adding a section tag with a class & fixed the date/time issue.

I believe the "Missing parameter type at position" notices that are showing up in pareview are unavoidable. If they are not, please correct me.

CSS errors have been pushed down to a minimal amount, anything above those cannot be squashed due to sass compilation using multiple includes, or commenting appearing slightly differently.

KrisBulman’s picture

Issue summary: View changes

added code review

KrisBulman’s picture

Just as an aside, documentation is constantly being updated here: https://github.com/krisbulman/aether/wiki

klausi’s picture

Status: Needs review » Needs work
Issue tags: -PAreview: review bonus

manual review:

  1. template.php: no need to determine the theme path as you are including files from your own theme which you already know where they are. Use something like require_once dirname(__FILE__) . '/mymodule.inc';
  2. array_interlace(): all functions that you define need to be prefixed with your theme's name to avoid name collisions.
  3. html5.js appears to be 3rd party code. 3rd party code is not generally allowed on Drupal.org and should be deleted. This policy is described in the getting involved handbook. It also appears in the terms and conditions you agreed to when you signed up for Git access, which you may want to re-read, to be sure you're not violating other terms. The Libraries API module is a recommended method for adding 3rd party dependencies without directly including the code on Drupal.org. Same for the other JS files.

But apart from that this looks nearly ready. Removing review bonus tag, you can add it again if you have done another 3 reviews of other projects.

KrisBulman’s picture

Status: Needs review » Needs work
Issue tags: -PAreview: review bonus

1. removed themekey global from template.php
2. prefixed array_interlace with theme name
3. I believe html5.js is allowed because it is dual licensed GPL and MIT and used liberally across distributions and themes.

The following major base themes include it:

Adaptivetheme

http://drupalcode.org/project/adaptivetheme.git/blob/d54132c4ab2b04be562...

Zen

http://drupalcode.org/project/zen.git/blob/73eb4aafed3e50c22e61734f59deb...

Boron

http://drupalcode.org/project/boron.git/blob/4b517271637873bf2d840ca8185...

Sasson

http://drupalcode.org/project/sasson.git/blob/a0f4e85ffbe3294d55925f1536...

Drupal 8 Core includes it:
http://drupalcode.org/project/drupal.git/blob/refs/heads/8.x:/core/misc/...

KrisBulman’s picture

Status: Needs work » Needs review
KrisBulman’s picture

Issue summary: View changes

Updated limitations

KrisBulman’s picture

Issue summary: View changes

webform classes review

KrisBulman’s picture

Issue summary: View changes

Added search modify review

KrisBulman’s picture

Issue tags: +PAreview: review bonus

added 2 to my original 4, totaling 6 reviews.
eligible for 2nd manual review via "PAReview: review bonus"

misc’s picture

Status: Needs work » Fixed
Issue tags: +PAreview: review bonus

Looks fixed to me.

misc’s picture

Status: Fixed » Reviewed & tested by the community

Sorry, wrong status.

misc’s picture

Issue tags: -PAreview: review bonus

Removing review bonus, please do more reviews to get a quicker approval.

klausi’s picture

Status: Reviewed & tested by the community » Fixed

Regarding the JS libraries: then all those themes are doing it wrong. They should add instructions how to retrieve those libraries instead of duplicating them all over the place. Drupal core could be considered a somewhat exception as it provides a foundation for any contributed project and to ensure that they all use the same library version.

Anyway, as the libraries seem to be all GPL compatible this is annoying, but not an application blocker for me.

Thanks for your contribution, KrisBulman! Welcome to the community of project contributors on drupal.org.

I've granted you the git vetted user role which will let you promote this to a full project and also create new projects as either sandbox or "full" projects depending on which you feel is best.

Thanks, also, for your patience with the review process. Anyone is welcome to participate in the review process. Please consider reviewing other projects that are pending review. I encourage you to learn more about that process and join the group of reviewers.

As you continue to work on your module, keep in mind: Commit messages - providing history and credit and Release naming conventions.

Thanks to the dedicated reviewer(s) as well.

Status: Fixed » Closed (fixed)

Automatically closed -- issue fixed for 2 weeks with no activity.

Anonymous’s picture

Issue summary: View changes

6 reviews, therefore eligible for 2nd manual review bonus