Updating readme date and version.
[project/bamboo.git] / README.txt
1 Version 1.8, January 16, 2013
2
3 -- SUMMARY --
4
5 Bamboo is a responsive Drupal 7 theme designed and developed
6 by Danny Englander (Twitter: @highrockmedia). Based on the CSS
7 Skeleton Framework, it allows for a choice of backgrounds,
8 color palettes, sidebars and fonts in the theme's settings page.
9
10 Bamboo is aimed at users who want to get a nice looking theme up
11 and running fast, and may not want to take the time to create
12 a sub-theme and fuss about with regions, settings, media queries,
13 and other super technical things. It's also aimed at the casual
14 Drupal user who has some familiarity with building sites. This
15 is designed with this type of user in mind, so it may not be
16 for the developer per se who would most likely use
17 Omega or Zen. This theme also does not require any base theme. There will
18 be an online demo soon and I considering offering some downloadable
19 Features as well, i.e. "Slideshow", "Gallery", etc...
20
21 -- CONFIGURATION --
22
23 - Configure theme settings in Administration  Appearance  Settings  bamboo
24 or admin/appearance/settings/bamboo and choose various options
25 available.
26
27 - For drop down menus to work, you need to set a main menu item to
28 "expanded". Then its sub-menus will work as drop downs.
29 If you need help with this, please consult Drupal core
30 documentation.
31
32 -- THEME SETTINGS UI --
33
34 - Choice of fonts:
35  (e.g, choose sans-serif or serif for headers and body seperately.)
36
37 - Choice of several backgrounds and textures
38
39 - Choice of three color palettes
40
41 - Toggle Breadcrumbs on or off
42
43 - Choice of Sidebar left or right (Note no sidebar will appear automtically,
44 you must assign blocks to that region.)
45
46 - Default logo changes for each color palette
47 You can also toggle this off and use your own logo.)
48 ***  Note, it's hard to anticipate what effect
49 various shapes and sizes a custom uploaded logos will have on the
50 theme so unfortunately support cannot be offered through the issue
51 queue for things like this.
52
53 - local.css
54 Check the box for local.css if you have copied or renamed
55 local.sample.css to local.css. This is for your own styling that will
56 not be overwritten with upgrades.
57
58 - Tertiary Menus
59 There is a theme setting checkbox if you will be using tertiary menus.
60 Check this box if you have sub-sub or third level drop down
61 menus. The setting does not change your menus, it merely styles
62 the last secondary level menu to not have rounded corners. This setting
63 was added to preseve the original styling of the theme for those who
64 are not using tertiary drop down menus. Note that tertiary menus in
65 mobile are indented already.
66
67 - Main Menu block region
68 Use this region if you turn off "Main Menu in the theme settings
69 and use your own third party menu system such
70 as Menu Block or Superfish Module. You are responsible for any
71 styling and CSS for this. (Use local.css as mentioned above.)
72
73 - Node block region - use this region to have a block region within a
74 node which will appear right after the content but before any node links
75 or comments. Useful for ads or otherwise.
76
77 -- ADDITIONAL FEATURES --
78
79 - JQuery Image captions on default imagefield in Article content type
80
81 - Responsive for phone, tablet, and desktop using media queries
82
83 - Mobile friendly menu
84
85 - Drop down menus (for desktop)
86
87 - Tertiary drop down menu styling
88
89 -- REQUIREMENTS --
90
91 No base theme needed, simply use this theme on its own.
92
93 -- INSTALLATION --
94
95 Install as usual, see http://drupal.org/node/176045 for further information.
96
97 -- CUSTOMIZATION --
98
99 * As with any other Drupal theme you are able to customize just about every
100 aspect of this theme but some nice defaults are provided out of the box
101 with Bamboo.
102
103 - drupal.org theme guide is here : http://drupal.org/documentation/theme
104
105 - it is recommended to create a sub-theme of your own to put all your overrides
106 in: "Creating a sub-theme" - http://drupal.org/node/225125
107
108 -- NOTES --
109
110 - This theme supports CSS3 features, i.e. round corners for modern browsers.
111 However, there is no support for IE8. Media Queries will not work in
112 IE8 but IE8 gracefully degrades to a 960 layout.
113
114 - Inspiration for this theme comes from my surroundings in glorious sunny
115 Southern California!
116
117 If you required specific customizations that you are not able to do on your own,
118 I can offer paid support. Please email me: contact@highrockmedia.com or
119 through my website's contact form. http://highrockmedia.com/contact-us
120
121 ------------------------
122 Danny Englander
123 Drupal Themer and Photographer
124 High Rock Media
125 San Diego, California
126 http://highrockmedia.com
127 http://highrockphoto.com