Socialtext Documentation: Recent Changes

Your Workspaces

System ProtoUser — Sun, 24 Feb 2008 11:08:59 -0000

Creator: System ProtoUser

Tags: Style Guide

Home: Socialtext Style Customization Guide
Up: Styling The Dashboard
Previous: Your Watchlist
Next: Styling The Page View

HTML Snippet

The sample only shows 2 rows.


  
    
      
        
          
            
              
                
                  
                    New Workspace

                  
                
              
            
          
        
      
    
    
      Your workspaces
    
  
  
    
      
        
          
            Socialtext
          
          
            211 changes
          
        
        
          
          
        
        
          
            Help
          
          
            57 changes

CSS Selectors

Selectors for the button are described at Standard Button.

#st-wikis
div.st-homepage-simplelist
#st-wikis-header
div.st-homepage-simplelist-header
#st-wikis-title
div.st-homepage-section-title
div.st-homepage-simplelist-title
a.st-homepage-simplelist-title-link
#st-wikis-content
div.st-homepage-section
table.st-homepage-simplelist-table
tr.st-homepage-simplelist-row-odd
td.st-homepage-simplelist-left
td.st-homepage-simplelist-left a
td.st-homepage-simplelist-right
td.st-homepage-simplelist-right a
tr.st-homepage-simplelist-row-even

Attachments: dashboard-yourworkspaces.png

Your Watchlist

System ProtoUser — Sun, 24 Feb 2008 11:08:59 -0000

Creator: System ProtoUser

Tags: Style Guide

Home: Socialtext Style Customization Guide
Up: Styling The Dashboard
Previous: What's New Page
Next: Your Workspaces

HTML Snippet

The sample only shows 2 rows.


  
    
      Your watchlist
    
  
  
   
     
       
         
           Styling The Dashboard
           
             Last edited by Socialtext User on Oct 25 7:29am
           
         
       
       
         
         
       
       
         
           What's New
           
             Last edited by Socialtext User on Oct 25 8:51am

CSS Selectors

#st-watchlist
div.st-homepage-simplelist
#st-watchlist-header
div.st-homepage-simplelist-header
#st-watchlist-title
div.st-homepage-section-title 
div.st-homepage-simplelist-title
#st-watchlist-title-link
a.st-homepage-simplelist-title-link
#st-watchlist-content
div.st-homepage-section
table.st-homepage-simplelist-table
tr.st-homepage-simplelist-row-odd
td.st-homepage-simplelist-left
td.st-homepage-simplelist-left a
div.st-homepage-whatsnew-attribution
span.st-homepage-whatsnew-author
span.st-homepage-whatsnew-date
tr.st-homepage-simplelist-row-even

Attachments: dashboard-watchlist.png

Your Watchlist List View

System ProtoUser — Sun, 24 Feb 2008 11:08:59 -0000

Creator: System ProtoUser

Tags: Style Guide

Home: Socialtext Style Customization Guide
Up: Styling The List View
Previous: What's New List View
Next: Recently Viewed List View

HTML Snippet


  
    Pages You're Watching
    
  
  
    
      Export
        
          Export checked to PDF
          Export checked to Word
        
      
    
  
   



  
    
    
    
      Title
    
    
      Last Edited By
    
    
      Date
    
    
      Revisions
    
  
  
    
       
    
    
      Styling The Dashboard
    
    Shawn Devlin
    Oct 25 9:33am
    
      4
    
  
  
    
       
    
    
      What's New
    
    Shawn Devlin
    Oct 25 9:24am
    
      3

	Title	Last Edited By	Date	Revisions
	Styling The Dashboard	Shawn Devlin	Oct 25 9:33am	4
	What's New	Shawn Devlin	Oct 25 9:24am	3

CSS Selectors

#st-list-title
#st-listtools
#st-listtools ul.level1
#st-listtools ul.level1 li.submenu
span#st-listtools-export
#st-listtools ul.level2
#st-listtools ul.level2 li.first
a#st-listview-submit-pdfexport
#st-listtools ul.level2 li.separator
a#st-listview-submit-rtfexport
div#st-actions-bar-spacer-clear
#st-watchlist-content
table.query-results-content
#st-watchlist-header-row
tr.query-results-header-row

#st-watchlist-header-watchlist
th.query-results-header-watchlist

#st-watchlist-header-title
th.query-results-header-title

#st-watchlist-header-last-edited-by
th.query-results-header-last-edited-by

#st-watchlist-header-date
th.query-results-header-date

#st-watchlist-header-revisions
th.query-results-header-revisions

tr.st-watchlist-row 
tr.query-results-row
tr.w-st-even-row
tr.w-st-odd-row

td.st-watchlist-row-watchlist
td.query-results-row-watchlist

td.st-watchlist-row-title
td.query-results-row-title

td.st-watchlist-row-last-edited-by
td.query-results-row-last-edited-by

td.st-watchlist-row-date
td.query-results-row-date

td.st-watchlist-row-revisions
td.query-results-row-revisions

Attachments: yourwatchlist-listview.gif

Your Notepad

System ProtoUser — Sun, 24 Feb 2008 11:08:59 -0000

Creator: System ProtoUser

Tags: Style Guide

Home: Socialtext Style Customization Guide
Up: Styling The Dashboard
Previous: Announcements And Links Box
Next: Did You Know

HTML Snippet


  
    
      edit
    
  
  
    Your Notepad

CSS Selectors

#st-personal-notes
div.st-homepage-section
#st-personal-notes-edit
div.st-homepage-notes-edit
#st-personal-notes-edit-link
#st-personal-notes-title
div.st-homepage-section-title
div.st-homepage-section-title a
#st-personal-notes-content
div.st-homepage-notes-content

Attachments: dashboard-notepad.png

Workspace Tour - Table of Contents

System ProtoUser — Sun, 24 Feb 2008 11:08:59 -0000

Creator: System ProtoUser

Tags: Welcome

This is a list of the pages in the Socialtext Workspace Tour. Click the first one to start the tour, or you can jump into the middle by clicking on one of the other links.

Working offline with Unplugged

System ProtoUser — Sun, 24 Feb 2008 11:08:59 -0000

Creator: System ProtoUser

Tags: Help

Back to Socialtext Documentation.

Contents: [Socialtext Documentation]

Socialtext Documentation (Unplugging more than 50 pages)

Socialtext Documentation (Working offline)

Socialtext Unplugged Introduction

Socialtext Unplugged allows you to work on your wiki while your computer is offline.

Socialtext Unplugged lets you "unplug" a set of wiki pages to your desktop or laptop computer. You can read and edit them on your computer, while you are not connected to the internet -- perhaps on an airplane or train or in a cafe with unreliable network access. Later, you can "sync" changes back to your wiki.

You can unplug recently changed pages in a wiki, a single page, or pages in a blog or tag group. Anywhere you see the blue Unplugged icon, you can unplug that set of pages. The unplug icon can be found on the dashboard of your wiki, at the bottom of every page, and at the top of lists of wiki pages such as what's new , tags, and the results of a search.

You will only see the Unplugged icon if unplugged has been enabled for your wiki by a wiki administrator. See Enabling and Disabling Unplugged

Below is a brief overview of the main features of Unplugged. If you would like to get started quickly, follow the Walkthrough to unplug recent changes.

Unplugging a page

You can unplug a single page by clicking the Unplugged icon at the bottom right corner of the page:

Unplugging a set of pages

To unplug the last 50 recently changed pages in a wiki, go to "What's New" and click the Unplugged icon. By default, unplugging "What's New" will give you the last 50 pages changed to work with on your hard drive while you're offline.

Unplugging more than 50 pages

Unplugging a large wiki may be very slow -- so slow that your browser will time out before you can unplug all the content. To avoid this problem, by default, if you click on the "unplug" icon on the dashboard of your wiki, you get the most recently changed 50 pages.

You work around the default by modifying the url to unplug the pages. You can change the number that appears in the url to increase or decrease the number of pages you get. For example, on a Mac, you can control-click on the Unplugged icon, copy the URL, paste it into the browser, and append ";count=100" to the url to get 100 pages instead of the default of 50. On a PC, right-click the Unplugged icon to copy the URL. For example, a url might look like this:

http://www.socialtext.net/open/index.cgi?action=unplug

and to modify it to unplug the last 100 pages, you would paste the following url into a browser window:

http://www.socialtext.net/open/index.cgi?action=unplug;count=100

You can find the total number of pages in a wiki by going to "What's New" and then "All Pages". The total number of pages is in parentheses in the top left hand corner of the page.

Working offline

Once you click the Unplugged icon, you can open the page or pages you have unplugged with your browser. Or you can save the unplugged pages to a convenient location on your computer, to be opened in a browser later. Either way of downloading the file will work, and will result in a saved file on your hard drive.

The screen you will work in should look like your normal browser window, containing something like this in the body of the page:

You may want to read through a few of the help files within Unplugged. The GettingStarted window has links to explanations of how to save changes, browse and edit, and sync changes. The Walkthrough to unplug recent changes is another good place to get started, and Unplugged's internal documentation contains more detail.

View page

Click on an underlined link to a page to view that page's content.

The page will open as a mini-window, or "tiddler", inside your main Unplugged browser window. Above each open mini-window is a toolbar with options like edit, save, and close.

Create page

Click on a word or phrase with a dotted underline to create and edit a new page, much as you would in a regular wiki page.

You can also create a page by clicking "New tiddler" in the right hand sidebar. Name your new page, create its text and click "done". When you sync, it will be added to the pages on your server.

Note: tags added while Unplugged will not sync to your server. You must add tags on the wiki directly, while you are online.

Edit page

Click "edit" in the top toolbar of a mini-window to edit the content of that window. In the edit window, the top right hand toolbar gives the option of "done", "cancel", or "delete".

Done

To save what you've typed in the edit and tagging windows, click "done" in the toolbar above that edit window.

Close

Clicking "close" on the toolbar above a mini-window will close that window. You can open it easily again from the list of pages in the sidebar. Clicking "close all others" in the toolbar of a mini-window will keep that mini-window open while hiding all others.

Save

Clicking "Save" in the "Backstage" toolbar at the very top of your Unplugged page will save all your changes to your hard drive. They won't be saved back to your server until you sync them.

Syncing pages will automatically save them to your hard drive.

You can click "Options" in the right hand sidebar and set the Autosave option to save changes to your hard drive every few minutes.

Syncing your pages back to the server

When you are ready to synchronize your unplugged pages back to the wiki on your server, click "sync" in the righthand sidebar.

A list of all the pages you have unplugged will appear. The pages you have changed will be highlighted in green, and will have the boxes next to them checked.

Click on the "sync" button at the bottom of the page, and your pages will synchronize with your wiki on the server.

The changed and sync-ed pages will now be highlighted in purple in the sync list view.

You can then click "close", up at the far right hand side of the page to close the sync window and return to the basic Unplugged interface, where you can continue editing and viewing pages.

If you sync pages without saving first, Unplugged will save the changed pages to your hard drive before syncing. You can also save them first on your hard drive, and then sync.

While you have been editing pages offline, some of those pages may also have been changed on the server. Unplugged will warn you of potential conflicts in editing, during the sync process.

If anyone else has changed a page on the server, you will get a warning and a choice to override those changes. The sync list will show the pages you have changed that also have been changed on the server highlighted in red, and the "Synchronization status" column for that page will indicate that it's been changed on the server.

If you write over changes someone else has made in your wiki, it's okay. Those changes won't be lost, and you can easily find them using the revision history. You can integrate and merge offline changes with online changes by clicking the "Revisions" option in the top right hand toolbar in your wiki. See Page revision history for a walkthrough of reverting to previous revisions as well as comparing and integrating two different revisions.

Enabling and disabling Unplugged

New wikis that are created using the wiki UI will be created with Unplugged turned on, by default. Existing wikis may or may not have Unplugged enabled. New wikis created by a system administrator using the Command Line Interface will not have unplugged turned on by default. The administrator may do so using the st-admin set-workspace-config command, below.

To turn Unplugged on and off for a wiki in the wiki UI, you must be a wiki administrator.

Click on "Settings" in the upper right hand toolbar of any wiki page.

Click on "Workspace Features" in the left hand sidebar. Near the bottom of the page, there are radio buttons to enable or disable Unplugged for a wiki.

Making this change will turn Unplugged on or off for all users of a wiki.

For server administrators

To turn off Unplugged for a wiki, your server administrator can use st-admin:

st-admin set-workspace-config --workspace workspacename enable_unplugged 0

And to turn it back on again by default, here is the command:

st-admin set-workspace-config --workspace workspacename enable_unplugged 1

Walkthrough to unplug recent changes

Here's a step-by-step Walkthrough to unplug recent changes. Unplug, save, change something, and sync the page back to your server.

Unplugged has many more capabilities and interesting features, which you can read about in the extra documentation that will come up on your browser when you unplug your wiki. However, following this basic walkthrough should be enough to get you started and working offline.

Back to Socialtext Documentation.

Attachments: backstage-menu.png, sidebaroptions.png, unplug_large.png, unplugged-logo-bottom.png, unplugged-sync-changed.png, unplugged-syncdone.png, unplugged-syncscreen.png, unplugged1.png

Wikiwyg Toolbar

System ProtoUser — Sun, 24 Feb 2008 11:08:59 -0000

Creator: System ProtoUser

Tags: Style Guide

Home: Socialtext Style Customization Guide
Up: Styling The Edit Window
Previous: Edit Toolbar
Next: Styling The List View

HTML Snippet


  
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
  


  
  
    
      
        
          
            
              
                
                  
                    Upload files

CSS Selectors

See Standard Button for the CSS selectors for the "Upload Files" button.

#st-page-editing-toolbar
#wikiwyg_toolbar
div.wikiwyg_toolbar
img.wikiwyg_button
img.wikiwyg_separator
#st-page-editing-uploadbutton
#st-edit-mode-uploadbutton

Attachments: editwindow-wikiwyg-toolbar.png

Wiki 101

System ProtoUser — Sun, 24 Feb 2008 11:08:59 -0000

Creator: System ProtoUser

Tags: Help

Using Socialtext is simple.

You read, write, link and remember.

Read

When you work in Socialtext, you work on pages. A Socialtext workspace is simply a collection of these pages, connected together through links. This makes reading a workspace very similar to reading the Web.

Socialtext workspaces are collections of pages.

Write

Socialtext workspace, however, are very different from the Web in an important way. You can edit the full text of any page. In fact, that is the essence of how you work in Socialtext: by creating and editing pages.

Every page in a workspace is editable. Just click, type, and save!

Link

Unlike the web, every page has its own unique name in a Socialtext workspace. This makes linking between pages easy. Just write the name of the page. Finding pages is also easier. They are called just what you name them.

Every page has a name. Linking to a page is as simple as writing its name.

Remember

Socialtext remembers every thing you write here. Anything done here can be undone. With Socialtext, you can enjoy the freedom to play with ideas comforted that you will never lose that award winning idea.

Socialtext keeps every revision of each page. Never worry again about losing a good idea.

Attachments: Browse-Collection_of_pages.png, Browse-Editing_pages.png, Browse-History.png, Browse-Link_is_name.png

What's New Page

System ProtoUser — Sun, 24 Feb 2008 11:08:59 -0000

Creator: System ProtoUser

Tags: Style Guide

Home: Socialtext Style Customization Guide
Up: Styling The Dashboard
Previous: Did You Know
Next: Your Watchlist

HTML Snippet

The sample only shows 2 rows.


  
    
      
        
          
            
              
                
                  
                    New Page
                  
                
              
            
          
        
      
    
    
      What's new in Socialtext 2.0 Custom CSS guide
    
  
  
    
      
        
          
            Styling The Dashboard
            
              Last edited by Socialtext User on Oct 25 7:29am
            
          
        
        
        
        
          
            Getting Started
            Last edited by Socialtext User on Oct 23 1:56pm

CSS Selectors

See Standard Button for the button selectors.

#st-whats-new
div.st-homepage-simplelist
#st-whats-new-header
div.st-homepage-simplelist-header
#st-whats-new-title
div.st-homepage-section-title
div.st-homepage-simplelist-title
#st-whats-new-title-link
a.st-homepage-simplelist-title-link
#st-whats-new-content
div.st-homepage-section
table.st-homepage-simplelist-table
tr.st-homepage-simplelist-row-odd
td.st-homepage-simplelist-left
td.st-homepage-simplelist-left a
div.st-homepage-whatsnew-attribution
span.st-homepage-whatsnew-author
span.st-homepage-whatsnew-date
tr.st-homepage-simplelist-row-even

Attachments: dashboard-whatsnew.png

What's the funny punctuation?

System ProtoUser — Sun, 24 Feb 2008 11:08:59 -0000

Creator: System ProtoUser

Tags: Welcome

Up: Workspace Tour - Table of Contents
Back: What if I make a mistake?

In the background, Socialtext formats pages with a few extra symbols, like brackets and asterisks, in the text. For the most part, when editing you can ignore this. However, you may come across these symbols, for example, while browsing through the page revision history. Additionally, you can use the symbols while editing in Advanced mode.

To learn how to use the symbols, when you're editing a page in Advanced mode, click the "Edit tips" link at the top.

How do I make links?

Attachments: Editing-page-edit-tips.png

Styling The Dashboard Last edited by Socialtext User on Oct 25 7:29am

What's New Last edited by Socialtext User on Oct 25 8:51am

Styling The Dashboard Last edited by Socialtext User on Oct 25 7:29am
Getting Started Last edited by Socialtext User on Oct 23 1:56pm