Issue #1925778 by davidwatson: Fixed image link borders in IE6, IE7 and IE8.
[project/aqueduct.git] / README.txt
1 CONTENTS
2 --------
3
4   * Introduction
5   * Installation
6   * Using Aqueduct
7   * Design Decisions
8
9
10 INTRODUCTION
11 ------------
12
13 Aqueduct is a Drupal distribution for professionals looking to showcase their
14 experience and prowess. While it may be used as-is to provide blog, portfolio
15 and basic page functionality, it is designed to be quickly extended through the
16 use of other modules. Though it comes with the Achromatic responsive theme
17 (based on Golden Grid), it may be used with any other theme.
18
19
20 INSTALLATION
21 ------------
22
23 Aqueduct is Drupal distribution. When first choosing your installation options,
24 select "Aqueduct," and the relevant modules, features and themes will
25 automatically be installed and enabled for you.
26
27 Typekit's League Gothic and Museo web fonts are both used in Achromatic if
28 they are available. If you would like to use these fonts, simply enable the
29 Typekit module, then provide your kit's API key at Admin > Configure > Typekit.
30
31
32 USING AQUEDUCT
33 --------------
34
35 Aqueduct has three main components: pages, blog posts, and portfolio pieces.
36 all three can be created via Admin > Content > Add Content.
37
38 Pages function just as they do in core, while blog posts are a more streamlined
39 alternative to the Blog module. The five most recent blog posts will appear in
40 the Recent Posts block, displayed in the sidebar by default, as well as a list
41 on the front page and a view on /blog.
42
43 Portfolio pieces behave in a very similar way. Those portfolio pieces that are
44 promoted to the front page will appear in the "Featured Projects" block, 
45 displayed on the home page by default.
46
47
48 DESIGN DECISIONS
49 ----------------
50
51 Q:  Why include feature modules in addition to aqueduct.install?
52 A:  Aqueduct makes the distinction between "hard" and "soft" configuration:
53     that is, configuration that is mandatory for the install profile to
54     function, and a set of sane defaults intended to be overwritten by the site
55     owner. Feature-based exports are ideal for setting hard configuration, as
56     it is easy to tell when they are overriden and rever them. By contrast,
57     default configuration not intended to be tracked should be done either in
58     custom modules or the profile's hook_install(), depending on the scope of
59     the change.
60
61 Q:  Why is Aqueduct Slideshow its own feature?
62 A:  In short, so it is easier for other modules to leverage. As a number of
63     modules make use of this functionality, it makes more sense to define the
64     presets once and have each other feature depend on them as necessary.