WUG_Retrofit+an+Existing+Initiative+Wiki

include component="page" wikiName="siframeworkdemo" page="space.template.inc_contentleft_wug_begin"

=
Learn how to retrofit an existing initiative wiki-space to utilize updated wiki templates and maintain a consistent look and feel. It is important to first review the content on this page and any template pages prior to implementing any changes to your initiative wiki. The initiative templates contain basic instructions and pre-populated content to help you get started.======

Each initiative wiki-space contains five standardized core pages (Initiative Dashboard, QuickStart, Charter & Members, Materials, Workgroups) and two required initiative-specific included-pages (Initiative PageTabs, Initiative SidebarRight).


 * 1) To begin, select your five core initiative wiki-pages.
 * 2) Next, create the initiative-specific included pages.
 * 3) Once the pages are created link all initiative pages to your new included pages.

NOTE: Do //NOT// modify any of the template files from which you will create your initiative wiki.

=1. Create Core Initiative Pages=

1.1. Select Existing Core Pages
Begin by determining which of your existing initiative pages will be used as the five core pages for your initiative wiki-space. The five core pages of each Initiative Wiki are listed below. Each core initiative page in the list links to the corresponding page in a Sample Initiative that provides further instructions and explanation for that page.


 * Initiative Dashboard - the central page to the initiative that provides members and non-members with a short intro, announcements, a road-map, and more.
 * QuickStart - provides stakeholders and non-stakeholders with the tools and materials on how to get involved with the initiative
 * Charter & Members - provides members with a more detailed outline of the initiatives charter, challenge, timeline, and more.
 * Materials - a deposit of initiative information (e.g. meeting notes, standards, publications, etc.).
 * Workgroups - an online meeting space for workgroups.


 * 1. || If your initiative wiki contains a lot of pages, you may need to search for all of the pages in your wiki. To start click on the **Pages or Files** link in the left sidebar. || [[image:wug_retrofit_clickpagesfiles.png width="896" height="478"]] ||
 * 2. || On the Pages and Files screen, search for all pages in your initiative wiki-space:
 * On the right, Filter by Type = select **Pages**
 * In the search field at the top, enter the name or acronym of your Initiative.

//**Note**//: You may need to do two separate searches, one with the full name of the initiative and one with the acronym, depending on how you named your initiative pages. || ||
 * 3. || Make note of which pages will be used as your five core pages. Most existing initiative wikis have pages that align directly with the new core page names. If your initiative wiki does not have five pages that can be used for the core pages, you will need to create the missing core pages as instructed below, Create Missing Core Initiative Pages below. || [[image:wug_retrofit_selectcorepages.png width="896" height="478"]] ||

1.2. Create Missing Core Initiative Pages
Follow the instructions under Create an Initiative Wiki Space - Step 1, Create Core Initiative Pages for any core pages that do not already exist.

=2. Create Initiative-Specific Included Pages= Each initiative wiki requires two initiative-specific pages that are included in their wiki:
 * 1) Initiative PageTabs - contains a simple bulleted list which is displayed as navigation tabs linking to your five core pages within your initiative wiki.
 * 2) Initiative SidebarRight - contains several other included pages that comprise the default initiative sidebar and allows each initiative to create a sidebar that is customized to their needs.

Follow the instructions under Create an Initiative Wiki Space - Step 2, Create Initiative-Specific Included Pages to create these required initiative-specific included pages.

=3. Link All Pages to Your Included Pages= Once you have your core pages and required included pages selected and created for your initiative wiki you need to link everything together so your initiative wiki will display with the correct S&I Framework wiki styles and use you initiative's PageTabs, and SidebarRight pages. This initial re-linking is slightly different for //YourInitiative// dashboard page than the rest of your initiative wiki pages. This is to enable slightly different styling of content in the main content area of //YourInitiative// dashboard page.
 * First, you will update the links to included pages for any new core pages you created. If you did not create any new core pages, skip to Step 3.2 Add Included Pages to All Existing Pages.
 * Next, you will add your included pages to all other existing initiative pages.

3.1 Update Included Page Links in New Core Pages

 * 1. || From any new core page your created:
 * Click **Edit** in the page toolbar to enter Edit mode. ||  ||
 * 2. || In Edit mode, you will update the links to the first three Included Page widgets:

Click on each Include Page widget and click **Edit Wdget**. Link each widget as follows:
 * First Include Page = //YourInitiative// SidebarRight
 * Second Include Page = do not change. (links to //inc_contentleft_begin//)
 * Third Include Page = //YourInitiative// PageTabs || [[image:wug_initdash_clickeditwidget.png width="896" height="521"]] ||
 * 3. || Once you've changed all the links, click **Save** in the editor toolbar to save your changes and exit Edit mode. || [[image:wug_initdash_saveedit.png width="896" height="521"]] ||
 * 4. || Repeat steps 1-3 for each new core page you created. ||  ||

3.2 Add Included Pages to All Existing Pages

 * 1. || From //YourInitiative// dashboard page:
 * Click **Edit** in the page toolbar to enter Edit mode. ||  ||
 * 2. || You will add three Include Page widgets to the very beginning and one Include page to the very bottom of each initiative page:
 * Click **Widget** in the editor toolbar to add a widget.
 * Click **Content of a Wiki Page** on the right to select the page.
 * In the **Embed the Contents of a Wiki Page** window, enter the following:
 * Wiki Name = siframework
 * Page Name = //YourInitiative// SidebarRight
 * Click **Embed Wiki Page** to close the Widget window
 * Repeat these steps to embed the second, third and last included pages:
 * Second Include Page Name = //inc_contentleft_dashboard_begin//
 * Third Include Page = //YourInitiative// PageTabs
 * Last Include Page Name = //inc_contentleft_end// || [[image:wug_initdash_clickeditwidget.png width="896" height="521"]] ||
 * 3. || Once you've changed add the four included pages, click **Save** in the editor toolbar to save your changes and exit Edit mode. || [[image:wug_initdash_saveedit.png width="896" height="521"]] ||
 * 3. || Repeat steps 2 and 3 for each initiative page, embedding the following pages. Note that the second included page name is different from that embedded on your dashboard page.
 * First Include Page Name = //YourInitiative// SidebarRight
 * Second Include Page Name = //inc_contentleft_initiative_begin//
 * Third Include Page = //YourInitiative// PageTabs
 * Last Include Page Name = //inc_contentleft_end// ||  ||

include component="page" wikiName="siframeworkdemo" page="space.template.inc_contentleft_end"