TUTORIAL

Want to know how to utilize the built-in features of Codex?
Below is a step-by-step tutorial designed to make your building
process smooth and easy.





BANNER IMAGE

To utilize Codex's built-in banner area for display of your images, please follow the instructions below.

1. Click and drag your image into the Resources area of the project file (banner images used on the preview site of Codex measured 1100px x 700px. Images with small dimensions may not display properly due to the size of the banner area on larger viewing devices). The Resources area can be found on the left hand column of RapidWeaver just below your webpages. (Please note that the Resources area is limited to RapidWeaver 5).

2. Insert the following code in the Custom CSS box within RapidWeaver (The Custom CSS area can be found by clicking on the Page Info icon at the top-right side of your project file. A panel will appear -- please click on the Header label. The Custom CSS box is located towards the center of the panel and labeled CSS):
#feature {background-image: url(%resource(my-image.jpg)%);}

3. Replace the "my-image" with the name of the image. (Please ensure that the name of your image is all lowercase and does not contain any spaces, characters, or symbols. Failure to do so may prevent the image from displaying upon publishing your site).

4. Your banner image will now appear in preview mode.



MAIN CONTENT/EXTRA CONTENT BACKGROUND IMAGE

To utilize the option of displaying a background image of your choosing for either the main content area, or the 6 Extra Content Areas, please follow the instructions below.

1. Click and drag your image into the Resources area of the project file. (Please ensure that your images are large, high quality images. Smaller images will not display clear or crisp). The Resources area can be found on the left hand column of RapidWeaver just below your webpages. (Please note that the Resources area is limited to RapidWeaver 5).

2. Insert the following code that corresponds to the background area you are targeting in the Custom CSS box within RapidWeaver (The Custom CSS area can be found by clicking on the Page Info icon at the top-right side of your project file. A panel will appear -- please click on the Header label. The Custom CSS box is located towards the center of the panel and labeled CSS):

MAIN CONTENT AREA ONLY
section #padding {background-image: url(%resource(my-image.jpg)%);}

EXTRA CONTENT AREA ONLY
#extraContainer? {background-image: url(%resource(my-image.jpg)%);}

3. Replace the "my-image" with the name of the image AND if utilizing the Extra Content Area, replace the ? with the appropriate Extra Content numbered area. Only Extra Content Areas 2-7 are useable options. (Please ensure that the name of your image is all lowercase and does not contain any spaces, characters, or symbols. Failure to do so may prevent the image from displaying upon publishing your site).

Please note that content background images may not re-size proportionally on tablet and handheld devices. This has nothing to do with the theme and everything to do with the functionality and limitations of those devices. As an alternative, Codex includes in the Toggle section labeled Background Solid Color on Tablet/Handheld Devices, the ability to utilize a background image on the desktop, but then convert the image to a background color of your choosing when viewing the page on tablet / handheld devices.

Internet Explorer 8 also has limitations with processing background images. As a result, when viewed in Internet Explorer 8, background images will convert to the solid color selected for the corresponding background area.



ONE-PAGE NAVIGATION

Please download the snippet labeled Codex Navigation (included with your theme download).

Once the Codex Navigation snippet has been downloaded, open up the Snippets tray within RapidWeaver, and drag the Codex Navigation Snippet to a Stacks 2 text box or Styled Text page in your project file.

Included in the snippet are navigation links for each of the content areas built-into Codex. The following lists the navigation links within the snippet to the corresponding content areas:

LINK #1 = Main Content Area
LINK #2 = Extra Content Area #2
LINK #3 = Extra Content Area #3
LINK #4 = Extra Content Area #4
LINK #5 = Extra Content Area #5
LINK #6 = Extra Content Area #6
LINK #7 = Extra Content Area #7

To change the name of the navigation link, replace the text "LINK #1" with the word/s of your choosing. If you do not need all seven links, simply remove the LINK # text for each of the links you will not need.

To ensure proper display and functionality of the one-page navigation, highlight the entire code of the snippet and click Clear Formatting, then Ignore Formatting under Format at the top left of your screen. If this is done correctly, the entire code will have a pink highlight.

It is important to reiterate that nothing within the snippet should change except for the labeling of the navigation links.




NAVIGATION LINK BACK TO HOMEPAGE


As seen on the preview site, links were created with a stacks page to direct visitors to the Tutorial, Style Options, and Pre-Sale Questions pages. All these pages were built with Codex, but used a different format for navigation. Instead of a one-page navigation feature, theses pages provide a return to home page option in Codex's navigation area. The following instructions will explain how to accomplish this same effect if you are needing visitors to view pages outside the one-page navigation site and would like for them to return to your home page built with Codex.

1. Please download the snippet labeled Codex Return to Home Page (included with your theme download).

2. Once the Codex Return to Home Page snippet has been downloaded, open up the Snippets tray within RapidWeaver, and drag the Codex Return to Home Page snippet to a stacks text box in your project file.

3. Replace the "#" with the url (full web address) of your main page.

4. Replace the text - THIS IS WHERE YOU PLACE YOUR NAVIGATION TEXT - with the text you would like to have appear for the link.

5. To ensure proper display and functionality of the return to home page navigation, highlight the entire code of the snippet and click Clear Formatting, then Ignore Formatting under Format at the top left of your screen. If this is done correctly, the entire code will have a pink highlight.

It is important to reiterate that nothing within the snippet should change except for replacing the # sign with your site's home web address, and the text for the link.




BUILT-IN-SLIDESHOW

To utilize Codex's built-in responsive slideshow for any page, please follow the instructions below.

1. Click and drag your images into the Resources area of the project file. The Resources area can be found on the left hand column of RapidWeaver just below your webpages. For proper display, please ensure slideshow images have a width of 1100px. The height does not require a set measurement but all images used for the slideshow must have the same height.

(Please ensure that the name of your image is all lowercase and does not contain any spaces, characters, or symbols. Failure to do so may prevent the image from displaying upon publishing your site).

2. Please insert the following code in a styled text box within Stacks:

<div id="myExtraContent8">
<div class="flexslider">
<ul class="slides">

<li>
<img src="%resource(my-image.jpg)%" />
</li>

</ul>
</div>
</div>


3. Replace the word my-image within the code to the name of the image you would like to have as the first image for your slideshow. You have now just completed your slideshow with 1 image.

4. For each additional image you would like to add to your slideshow, you will need to add the following line of code for each image:
<li>
<img src="%resource(my-image.jpg)%" />
</li>


The code below shows the additional line of code should be placed after the first li sequence, and what your text box area should look like for a slideshow with two images. You may continue to add images to your slideshow as needed. Please note that images will appear in corresponding order.

<div id="myExtraContent8">
<div class="flexslider">
<ul class="slides">

<li>
<img src="%resource(my-image.jpg)%" />
</li>

<li>
<img src="%resource(my-image.jpg)%" />
</li>

</ul>
</div>
</div>


5. To ensure your slideshow displays correctly, highlight the entire code in the text box area and click Clear Formatting, then Ignore Formatting under Format at the top left of your screen. If this is done correctly, the entire code will have a pink highlight.

Please verify that the Display On under Built-In-Slideshow in the Styles section of RapidWeaver has been selected. There is also an option to choose between a slideshow that will transition images with a fade-in, fade-out feature, or slider effect under Built-In Slideshow Transitions in the Style Options section.



LOGO

Codex has the capacity to accommodate a logo and will display it above the site title. If the site title is not utilized, the logo will display where the title is placed. There are no set width or height requirements for the logo, however, since Codex is a responsive theme, a logo with a significant height may disrupt the layout on smaller devices.



EXTRA CONTENT AREAS

Codex contains 6 Extra Content Areas to expand your design choices and options. The Extra Content Areas are limited to using the Extra Content Stack with Stacks 2. You can download the Extra Content stack for free under Extra Content Stacks Plugin at the following link: http://extracontent.org.

When using the Extra Content stack, it is important to target the content within the stack if using margin or padding. Margin and padding should not be applied to the actual Extra Content stack that contains the content.

Please note that the Extra Content Areas begin with Extra Content #2 and end in Extra Content #7. Do not use any other Extra Content Areas as they are being utilized for other functions related to the theme. The Built-In Style options of theme include the ability to utilize your own custom background image, or a solid color of your choosing.


FLUID VIDEO

Codex will ensure your videos adjust appropriately no matter how small or large the device is being used. Codex supports embedded video from the following sites:

1. You Tube
2. Vimeo
3. KickStarter
4. Viddler
5. Blip

Once you have embedded your video from any of the compatible media sites listed above, highlight the code used for embedding and click on "Ignore Formatting" under Format. Your video is now set-up and ready to display appropriately on multiple devices.

(Please note that embedded video is not the actual link to the video but a string of generated code).




RESPONSIVE STACKS/ THIRD PARTY PRODUCTS

Codex is a theme that requires Stacks 2 if you are to utilize any of the built-in Extra Content Areas #2-#7. Codex is also a responsive theme. As a result, it is imperative to ensure that any stacks used with Stacks 2, or any 3rd party products are responsive as well. Joe Workman's responsive stack package is a great place to start your collection of responsive stacks and can be found at the following link: http://joeworkman.net/rapidweaver/stacks/responsive-layout/. The fluid image stack was used for the images on the main page of this preview site.

Please note that standard stacks margin and paddings may not display properly with Internet Explorer 8.


DISABLING CONSOLIDATE CSS

If you are experiencing any display issues with the theme, or if certain style options are not working properly, please disable the RapidWeaver Consolidate CSS File setting within Preferences. The disabling of this setting should restore your style option selections and display issues.


RAPIDWEAVER MANUAL

If you are new to the RapidWeaver community, or come across a setting that you are not quite sure of, the team at RealMac has compiled a great resource for RapidWeaver users and answers many questions about the software. From instructions on how to create sub-navigation pages to explaining the Resources area, you will most likely learn something new about RapidWeaver after reviewing the manual. You can find the manual at the following link: http://realmacsoftware.freshdesk.com/solution/categories/14470/folders/24470.



SOCIAL ICONS

To utilize Codex's built-in social icons, please follow the instructions below.

1. Insert the following code in a styled text page within Stacks:
<a class= "social" href= "#">f</a>
2. Replace the # with the page URL of your social icon.
3. Replace the letter f with the corresponding symbol of the social icon of your choice using the chart below.
4. Highlight the entire code and click Clear Formatting, then Ignore Formatting under Format at the top left of your screen.
(For multiple social icons, repeat the above steps for each desired icon.)
Stacks Image 173
To utilize the second set of built-in social icons, please follow the instructions below.

1. Insert the following code in a styled text page within Stacks:
<a class= "social1" href= "#">f</a>
2. Replace the # with the page URL of your social icon.
3. Replace the letter f with the corresponding symbol of the social icon of your choice using the chart below.
4. Highlight the entire code and click Clear Formatting, then Ignore Formatting under Format at the top left of your screen.
(For multiple social icons, repeat the above steps for each desired icon. Please note that for now, regardless of the order of icons, the first set will always display before the second set of icons).
Stacks Image 23