afuna: Cat under a blanket. Text: "Cats are just little people with Fur and Fangs" (Default)
afuna ([personal profile] afuna) wrote in [site community profile] dreamscapes2009-07-18 03:44 pm

Dreamscapes Entry Guidelines

These guidelines are obsolete! Do go visit the newer versions of the guidelines instead

[site community profile] dreamscapes is the community for official style submissions, as well as any discussion or process related to official style submissions.

What kinds of entries belong in [site community profile] dreamscapes?

Draft

Draft entries are unfinished stylesheets or layers posted for comment or help.

Tag these with "draft".

Conversion

Conversion entries contain CSS themes which are finished in terms of design, but which need to be converted to use S2 variables. Posting up a conversion entry signals that you want to find someone willing to help convert things to S2.

Tag these with "conversion".

Needs Testing

Entries needing testing are finished themes which you'd like people to look at in different views, or try with different browsers, just to be sure.

Tag these with "needs testing".

Patch

Sometimes your theme needs to override the ordering of HTML or the output of a function in S2 in order to display properly. (For example, wrapping the username and the usericon in a div). Entries tagged with "patch" can contain either requests for such an alteration, or the code to do it.

Tag these with "patch".

Submission

Submissions are finished themes that have been converted to use S2 variables and tested (either on this community or to your own satisfaction elsewhere), and are ready to go live!

Please note, before we can accept a submission to become an official layout, we need your CLA, and that we need to make sure that we have permission to use/distribute any images that come with your layout. See below for more detail about the CLA.

Tag these with "submission".

Misc entries

Besides actual layout/layer submissions, entries that are related to making styles may be posted to [site community profile] dreamscapes. These include calls for collaboration, sharing resources, tutorials, or sharing common issues/useful tips when working with a theme for a layout (for example, techniques to avoid or use with Tabula Rasa).

We'll tag these as necessary.

What do I need to do when submitting a layout or theme?

First step is to send your Contributor License Agreement by email to denise@dwscoalition.org or by mail to Dreamwidth Studios, LCC, PO Box 39608, Baltimore MD, 21212. This is very important. The CLA basically says that you give us permission to use and redistribute your code and your images. It does not give us exclusive rights to any of them. Please remember that no submission from you can be patched or loaded to the site until your CLA is on file!

If your layout or theme has any images, we need to know where they came from so that we can know whether Dreamwidth may use them. All images must be either your own creation that you are willing to release to Dreamwidth for use and distribution as per the CLA, or else licensed appropriately. If you used a stock photo, we need a link to where it came from, so that we can double-check the licensing terms of the site.

Make sure that your layout or theme is compatible with the latest two versions of Firefox, Chrome, Safari, and IE. Compatibility with the latest Opera and with Firefox 3.6.x is also highly desirable.

For accessibility and general readability, all layouts and themes must be fluid, not fixed width, and, as much as possible, be able to accommodate both large and small font sizes. Icons should be the standard icons, though exceptions are possible; if the icon accompanies text, the text should be the standard text. Please test your layout with small screens and large fonts, to make sure it does not break easily for users who have different defaults than your own. Use proportional units such as ems or percentages for non-graphic elements.

If you want to test or tweak your layout or theme a bit more, post it with the needs testing or draft, with any relevant details.

If you have a CSS-only layout is complete and ready to go as-is, post it with the conversion tag, and we'll begin the process of converting it to use S2 variables as necessary (let us know what level of participation works for you in this step! I know that S2 is not everyone's cuppa.)

Then when it's ready post it again as a submission so that we know it's ready to go! (For the submission, especially, tell us what name you want us to credit your layout under).

To post to [site community profile] dreamscapes, use the Post to Community link on the profile. Posting is open to everyone; you do not need to be a member of the community to submit an entry.

Required Metadata

Each entry should be tagged with the base style the layout applies to, the type of entry as above, with "-not filed", and with an ":unclaimed". It should also have this header:



For example:
Theme name/layout: Tabula Rasa Plain / Tabula Rasa
Author: [personal profile] afuna
Layout info: layout layer
Image info: No images
Additional info: uses the layout stylesheet; supports one- two- three-columns, both left and right; modules look okay even when they've been moved around.
(tagged: submission, ~tabula rasa, -not filed, :unclaimed)

If you're linking to an s2 layer, add these two lines to allow others to view your code, and to easily set up your theme layer for preview:
layerinfo "source_viewable" = 1;
layerinfo "is_public" = 1;

It is also advisable to include links to the source and a preview of anything you submit. There is a entry on how to make a preview of your layout or theme here.

The "-not filed" tag simply indicates that your layout or theme has not been migrated to Dreamwidth's bug tracking system, and makes it easier to keep track of which entries still need attention, and which ones have already been handled. The ":unclaimed" tag indicates that no coder has claimed your layout or theme to patch it. (Once someone has picked it up, we'll change that to a ":claimed")

What do I do with entries I'm not sure belong here?

If your entry doesn't fit into any of the above categories, but you think it fits in this community, please first contact the community administrators before posting!

If you:


Do color themes count as submissions?

Yes! See The Quick and Dirty Guide to Creating Color Themes if you don't know how to create one already. We are always happy to see more themes.

I've submitted my layout/theme, now what? How do I know if it will be accepted? How will I know if it is going to be rejected?

You've submitted your layout, and now... you'll probably wait. You can keep an eye on your submissions tags to see when the "-not filed" tag is removed and :claimed is added. Once your submission is filed, you can see its entry on DW's Bugzilla. Then we all wait for a coder to take on that "bug" and patch your submission! Once it is patched and put in line for the next code push, the entry will be tagged :committed.

Any work that has to be done to ready your layout will add to the time, of course. Conversion to S2, in particular, tends to take longer than taking an already-S2 layout and doing the final bits to make it an official style. Any modifications of the layout, for example, if it needs a bit of polishing to make it fluid width and otherwise fit our guidelines, that may take longer still.

There are only a few things which would outright prevent a layout from being used:
  • it is based on a layout that is licensed so that Dreamwidth cannot make use of derived layouts

  • it uses stock images that are licensed such that Dreamwidth may not use them
Even if some images can't be used, we'd be happy to accept variants of the original layout with other images or without images. Some good places to look for stock images are listed on the wiki.

If there are other issues, such as the layout not following the guidelines, we'd be happy to work with you on the layout further until they do fit our guidelines. This would happen if the layout were:
  • substantially broken, or so as to be unusable in one of the browsers we support (inconsistencies in appearance are all right)

  • fixed width

  • lacked visual differentiation between visited and unvisited links

If your layout is any of these, we'd be happy to work with you to fix them, or to ask someone to do the fixing (especially if it's an issue with IE, and you don't have access to IE -- as has been the case before!). Just let us know, if you're going to be able to work further on your layout, or if you'd prefer that we try to find someone who can do it for you.

Where do I get started?

This is by no means a comprehensive list, but:
ninetydegrees: Drawing: a girl's face, with a yellow and green stripe over one eye (Default)

Bug fixes/Improvements: where?

[personal profile] ninetydegrees 2009-09-12 09:05 am (UTC)(link)
Where do we post entries improving or fixing a layout we've submitted once it went live? Thanks to the fixing of http://bugs.dwscoalition.org/show_bug.cgi?id=1752 and http://bugs.dwscoalition.org/show_bug.cgi?id=1658 I'll be able to make some parts of Funky Circles exactly look like I wanted them to be.
ninetydegrees: Drawing: a girl's face, with a yellow and green stripe over one eye (Default)

Re: Bug fixes/Improvements: where?

[personal profile] ninetydegrees 2009-09-12 04:53 pm (UTC)(link)
Got it, thanks. I can't really improve the multiform area because the changes aren't modifications of Core code but I could do the Tags page: http://dreamscapes.dreamwidth.org/10193.html?thread=154065#cmt154065
ninetydegrees: Drawing: a girl's face, with a yellow and green stripe over one eye (Default)

Re: Bug fixes/Improvements: where?

[personal profile] ninetydegrees 2009-09-13 03:58 pm (UTC)(link)
I wanted to have the management list and the interaction list on one line but that put 'Mass action...' on the line too. Now I can display it as a block and separate it from the lists. So, no, I don't think this is useful for other layouts.
ninetydegrees: Drawing: a girl's face, with a yellow and green stripe over one eye (Default)

[personal profile] ninetydegrees 2009-09-20 01:30 pm (UTC)(link)
I'm almost done with another Funky Circles theme (http://900degrees.dreamwidth.org/?s2id=91082) but one issue I have is that the link color for days with entries in the mini-calendar is too light. In the CSS I set days with entries to use the entry background color and the entry border color. It obviously doesn't work when these two colors are two close. Should I submit a fix to add new properties, fix the CSS, etc. in the original layout and live theme or is there anyway to override the CSS for just one theme?
ninetydegrees: Drawing: a girl's face, with a yellow and green stripe over one eye (Default)

[personal profile] ninetydegrees 2009-09-20 03:34 pm (UTC)(link)
Got it! Thanks! I'll also help me with two other themes where I want to change the background color.
ninetydegrees: Drawing: a girl's face, with a yellow and green stripe over one eye (Default)

[personal profile] ninetydegrees 2009-11-02 02:23 pm (UTC)(link)
A suggestion if I may: in the info layout designers provide, could they mention if modules are supposed to be movable (from header to footer, sidebar to footer, etc.)? I noticed some layouts didn't look so good when you departed from the default and yet we've made it possible to customize this by using the generic use module_xxx_group properties. I've just filed another bug about this for Skittlish Dreams.

This and how is the layout supposed to be displayed (one column, two columns-left, etc.). I know it's been asked several times.
ninetydegrees: Drawing: a girl's face, with a yellow and green stripe over one eye (Default)

[personal profile] ninetydegrees 2009-11-04 12:10 pm (UTC)(link)
It looks great! :)
ninetydegrees: Drawing: a girl's face, with a yellow and green stripe over one eye (Default)

Clarification needed

[personal profile] ninetydegrees 2009-11-08 10:11 am (UTC)(link)
As evidenced by this entry and some of its comments, it seems a bit unclear that all entries should follow the guidelines outlined in "What do I need to do when submitting a layout?" and use the posting template. The ambiguity comes from the word 'submission' which can either mean you're posting the final version of your layout/theme or that you're posting an entry. I think this section should be moved to the top and the more detailed tagging explanations integrated to it. And maybe we could rename the tag 'submission' to something less ambiguous.
ninetydegrees: Photo: bingo chips (bingo)

What about fonts?

[personal profile] ninetydegrees 2010-01-20 04:16 pm (UTC)(link)
Is it possible to integrate fonts to our styles via @font-face? (Provided the licensing allows it of course).
ninetydegrees: Drawing: a girl's face, with a yellow and green stripe over one eye (Default)

Re: What about fonts?

[personal profile] ninetydegrees 2010-01-20 04:23 pm (UTC)(link)
Yes and even have other generic fonts as a fallback (such as Verdana, etc.). @font-face just allows the user to download the font I think. It doesn't get used unless you use font-family somewhere else.
ninetydegrees: Drawing: a girl's face, with a yellow and green stripe over one eye (Default)

Re: What about fonts?

[personal profile] ninetydegrees 2010-01-20 04:40 pm (UTC)(link)
Sorry, I can't answer these questions.
ninetydegrees: Drawing: a girl's face, with a yellow and green stripe over one eye (Default)

Re: What about fonts?

[personal profile] ninetydegrees 2010-01-21 01:07 pm (UTC)(link)
Great article. Thanks!

* Yes, DW would have to host it and we would have to check the license. The easiest fonts to use are open free ones since the Open Font License actively encourages users to use @font-face.

* *nods*

BTW you can see how it works (or fail to) here: http://www.ninetydegrees.hack.dreamwidth.net/users/system/

This page loads fine for me in FF but is a quite slow to load on IE8 (and the fonts aren't used there since they're in a format IE doesn't understand).
Edited (Edited because it works in IE now.) 2010-01-21 17:30 (UTC)
ninetydegrees: Drawing: a girl's face, with a yellow and green stripe over one eye (Default)

Re: What about fonts?

[personal profile] ninetydegrees 2010-01-30 10:14 am (UTC)(link)
What do you think of making an option to turn font embedding off so that @font-face is empty or partially empty if the option is set to 'Yes' or something like that.
ninetydegrees: Drawing: a girl's face, with a yellow and green stripe over one eye (Dreamsheep B&W)

OT: pimping Dreamssheep icons

[personal profile] ninetydegrees 2010-02-28 12:37 am (UTC)(link)
Would it be ok to pimp these icons in the community?

Maybe I can add current stats to make this less OT-ish.
denise: Image: Me, facing away from camera, on top of the Castel Sant'Angelo in Rome (Default)

[staff profile] denise 2011-12-25 06:59 pm (UTC)(link)
ps, this links to the CLA download on the wiki (outdated address) -- can you change it to link to bug 85 instead?
fu: Close-up of Fu, bringing a scoop of water to her mouth (Default)

[personal profile] fu 2011-12-27 05:17 am (UTC)(link)
It looks like someone tweaked the wiki to point to the new CLA - do you stil want me to change the link?
denise: Image: Me, facing away from camera, on top of the Castel Sant'Angelo in Rome (Default)

[staff profile] denise 2011-12-27 05:31 am (UTC)(link)
as long as it's the new one that's linked, s'all good
fu: Close-up of Fu, bringing a scoop of water to her mouth (Default)

[personal profile] fu 2011-12-27 05:52 am (UTC)(link)
*salutes*
alchemy: Raja (Default)

Google Web Fonts

[personal profile] alchemy 2012-01-10 10:30 pm (UTC)(link)
I saw the old thread above regarding @font-face; I'm wondering what DW's position is on utilizing Google Web Fonts now that more and more browsers are supporting web fonts in general. I absolutely understand if relying on Google isn't something DW wants to do, but before I get to updating my old themes to submit, I thought I'd check.
ninetydegrees: Drawing: a girl's face, with a yellow and green stripe over one eye (Default)

Re: Google Web Fonts

[personal profile] ninetydegrees 2012-08-23 07:11 pm (UTC)(link)
Late answer but I have good news (well, depends on how you stand on S2). Designers can now use the font_sources property in layers to fetch Google Fonts via Google's own handy API.

Examples:

set font_sources = "http://fonts.googleapis.com/css?family=Iceland";
set font_sources = "http://fonts.googleapis.com/css?family=Iceberg|Rochester";

Also, I *love* your layout. I bookmarked it just the other day. :)
anthologia: (sounds kind of silly when I say it)

[personal profile] anthologia 2012-02-03 08:13 pm (UTC)(link)
/raises hand timidly

So, um, I have some themes that are tagged as claimed (and also as needs testing, though I did finish testing it in other browsers), but aren't on the Bugzilla page that I can see. Did it get lost, or am I just failing at something?
anthologia: (be kind to yourself.)

[personal profile] anthologia 2012-02-04 07:41 pm (UTC)(link)
!!!! :D! Yay, thank you!
fascination: A crop of the cover of Florence + The Machine's 'Lungs' album (Between Two Lungs.)

[personal profile] fascination 2012-12-28 08:16 pm (UTC)(link)
I submitted an entry earlier this week, and it's still in the queue; do you know if it will appear, or if I need to modify the post in order for it to be accepted?
fu: Close-up of Fu, bringing a scoop of water to her mouth (Default)

[personal profile] fu 2012-12-29 06:20 pm (UTC)(link)
Sorry about that, posted the entry!
forests_of_fire: A woman with shoulder-length black hair. She has a friendly, but serious smile on her face. (Oleander: Default)

Concerning images?

[personal profile] forests_of_fire 2013-03-19 02:14 pm (UTC)(link)
Okay, I've been tweaking our personal layout and was thinking of submitting some of my stuff, but I've been using mostly images that I colored over at Colourlovers for my backgrounds.

All the patterns on that site are licensed through the Creative Commons as long as you give credit for the pattern to the original creator. I imagine that could be done via a link to the creator's user profile on there. I'd only use the backgrounds that are licensed for commercial use. So, ultimately, this would be the license.

Would I be able to use those backgrounds for style submissions?
denise: Image: Me, facing away from camera, on top of the Castel Sant'Angelo in Rome (Default)

Re: Concerning images?

[staff profile] denise 2013-03-20 02:21 am (UTC)(link)
we can use things that are licensed CC-BY-SA, but we can't use things that are licensed CC-BY-NC-SA. last time i checked, colourlovers' patterns are all BY-NC-SA, so we can't use them. :(

if something's licensed BY-SA we can use it, though, and we have procedures set up for how to handle that.
forests_of_fire: A picture of a brilliantly colored waterfall cascading into a river (Default)

Re: Concerning images?

[personal profile] forests_of_fire 2013-03-20 08:50 am (UTC)(link)
Actually, if you look at this pattern (the one I'm currently using), the ones that are able to be used for commercial use are CC-BY-SA. A lot of them are CC-BY-NC-SA, though.
denise: Image: Me, facing away from camera, on top of the Castel Sant'Angelo in Rome (Default)

Re: Concerning images?

[staff profile] denise 2013-03-20 08:52 am (UTC)(link)
if the individual pattern is CC-BY-SA (or just CC-BY or CC-SA) then yes, we can use it! i'd never seen one that wasn't CC-BY-SA-NC, though.
forests_of_fire: A woman with shoulder-length black hair. She has a friendly, but serious smile on her face. (Oleander: Default)

Re: Concerning images?

[personal profile] forests_of_fire 2013-03-20 08:55 am (UTC)(link)
Awesome. There aren't a ton of pattern templates that are available for commercial use, but there are enough that I can play lots. XD

What kind of documentation would I need to send outside of my CSA? Just the link to the pattern template maker's profile?
denise: Image: Me, facing away from camera, on top of the Castel Sant'Angelo in Rome (Default)

Re: Concerning images?

[staff profile] denise 2013-03-20 08:57 am (UTC)(link)
yup, when you post the entry here just include all the information about the images, including links
forests_of_fire: A woman with shoulder-length black hair. She has a friendly, but serious smile on her face. (Oleander: Default)

Re: Concerning images?

[personal profile] forests_of_fire 2013-03-20 09:04 am (UTC)(link)
Yaaay! Thanks. You've totally made my month. XD