From 99a4bb63c780a939673e2153226635133fbba0eb Mon Sep 17 00:00:00 2001 From: Andrew Manning Date: Sun, 27 Nov 2016 12:52:35 -0700 Subject: Added Tutorials section with a Personal Channel tutorial --- doc/tutorials/personal_channel.html | 181 ++++++++++++++++++++++++++++++++++++ 1 file changed, 181 insertions(+) create mode 100644 doc/tutorials/personal_channel.html (limited to 'doc/tutorials/personal_channel.html') diff --git a/doc/tutorials/personal_channel.html b/doc/tutorials/personal_channel.html new file mode 100644 index 000000000..6a65461ed --- /dev/null +++ b/doc/tutorials/personal_channel.html @@ -0,0 +1,181 @@ +

Table of Contents

+ + + +
+ +

Personal Channel

+ +

This tutorial is intended to be followed in sequence as if you were setting up a +channel for the first time. It introduces some of the tools and features related +to a personal channel in a natural way.

+ +

Create a new channel

+ +

When you log in for the first time after registering, you must create a channel. +(Alternatively you can load https://grid.reticu.li/new_channel)

+ +

image

+ +

Enter your name and a nickname for the channel address, and select a "role". +Typically if this is a personal channel that represents you, select a Social role +with a level of default privacy that you are comfortable with. If you are unsure, +select Social - Restricted.

+ +

Configure your channel features

+ +

When your new channel is created you are directed to the channel settings page. +Take the time to look around at all the settings pages to familiarize yourself with +your options, even if you don't understand everything you see right now.

+ +

Navigate to the Additional Features settings and follow the screenshots below to +enable various features. Remember to press the Submit button when you are done with +your selections.

+ +

imageimageimageimage

+ +

Add a profile photo

+ +

Navigate to your channel home by clicking the "Home" icon on the left side of the +navbar, and then select the About tab to view your profile.

+ +

Press the Edit button on the right to edit your profile information.

+ +

image

+ +

From the Profile Tools dropdown menu, select the Change profile photo

+ +

image

+ +

Upload your photo and size as necessary using the image editor.

+ +

image

+ +

When you press Submit you will be redirected back to the profile editor. +(You might need to clear your browser cache if you have trouble seeing the new photo.)

+ +

image

+ +

Returning to your channel home page you will see that a post notifying others of your new +profile pic has been automatically posted.

+ +

image

+ +

Compose a post

+ +

Go to your channel home and open the post editor by pressing the Share textbox +at the top of the channel "wall". Enter a message, and then drag-and-drop an image +file into the post editor text area (alternatively you can use the Attach file +tool at the bottom).

+ +

image

+ +

Your image file will be automatically uploaded and stored in your cloud files, and +a link will appear in the post window. Pressing the post preview button will allow you to preview your post before publishing it.

+ +

image

+ +

Pressing the lock button near the Submit button will open the Access Control List +so you can specify exactly who can access this post.

+ +

image

+ +

Use an uploaded image as a channel cover photo

+ +

One way to add some pizzazz your channel is to add a cover photo that visitors will +see when they load your channel page. Hubzilla's integrated cloud file system +allows you to choose an existing photo for this purpose.

+ +

Visit your photos in the Photos app

+ +

image

+ +

Select the photo you wish to use and select Use as cover photo from the Photo Tools +dropdown menu.

+ +

image

+ +

Crop the image using the photo editor and save your changes.

+ +

image

+ +

When you load your channel home page, you will first see the cover photo, and your +channel page will fade in as you scroll down.

+ +

image

+ +

Make a connection

+ +

Making connections between channels to share things is what Hubzilla is all about. +Making a connection is simple. If you do not already know how to reach a channel's home +page, you might try a directory search by opening the Directory link on the right +side of the top navbar.

+ +

image

+ +

You can connect directly from the directory entry using the Connect button there, +or you can open the channel page first and press the Connect button below the +profile photo.

+ +

image

+ +

After you connect you are immediately taken to the connection editor page, where +you make some important decisions about what you plan to share with this channel.

+ +

image

+ +

The two important settings are

+ +

The individual permissions are mostly straightforward, but they can be slightly +unclear at first. For example, Can view my file storage and photos does not +mean that the connected channel will be able to view all of your photos and files! +It means that you will have the option to share photos and files with that +channel. It is perfectly possible for you to allow someone to read your posts but +disallow them from seeing photos in that post. This kind of unusual situation is, +as they say, not a bug; it is a feature.

+ +

Privacy groups allow you to conveniently share items with groups of people. You can +create whatever groups fit your needs by opening the Add privacy group link.

+ +

image

+ +

In this editor, you can switch between the existing privacy groups and see at a +glance what channels are and are not members of the group. Selecting the icon of +a channel in either box will move it to the in or out of the group.

+ +

image

+ +

When editing an individual channel's settings, you can set their privacy group +membership using the widget on the left:

+ +

image

+ +

Connections are a mutual engagement. The channel you connect can choose to approve your +connection. They will receive a notification that you connected

+ +

image

+ +

which takes them to their Connections editor page where +they can choose to approve the connection or not.

+ +

image

+ +

After you approve a connection, it is a good idea to open the individual connection +editor by pressing the edit button beside the Delete button.

+ +

image

+ + \ No newline at end of file -- cgit v1.2.3 From 7470b1180e884104b690b39dce90143c72c096a3 Mon Sep 17 00:00:00 2001 From: Andrew Manning Date: Sun, 27 Nov 2016 13:43:07 -0700 Subject: Add ability to include page assets in documentation pages such as images. Updated Personal Channel tutorial to use local images using this new capability. --- doc/tutorials/personal_channel.html | 48 ++++++++++++++++++------------------- 1 file changed, 24 insertions(+), 24 deletions(-) (limited to 'doc/tutorials/personal_channel.html') diff --git a/doc/tutorials/personal_channel.html b/doc/tutorials/personal_channel.html index 6a65461ed..f8dc4c628 100644 --- a/doc/tutorials/personal_channel.html +++ b/doc/tutorials/personal_channel.html @@ -26,7 +26,7 @@ to a personal channel in a natural way.

When you log in for the first time after registering, you must create a channel. (Alternatively you can load https://grid.reticu.li/new_channel)

-

image

+

image

Enter your name and a nickname for the channel address, and select a "role". Typically if this is a personal channel that represents you, select a Social role @@ -43,7 +43,7 @@ your options, even if you don't understand everything you see right now.

enable various features. Remember to press the Submit button when you are done with your selections.

-

imageimageimageimage

+

imageimageimageimage

Add a profile photo

@@ -51,26 +51,26 @@ your selections.

navbar, and then select the About tab to view your profile.

Press the Edit button on the right to edit your profile information.

- -

image

+ +

image

From the Profile Tools dropdown menu, select the Change profile photo

-

image

+

image

Upload your photo and size as necessary using the image editor.

-

image

+

image

When you press Submit you will be redirected back to the profile editor. (You might need to clear your browser cache if you have trouble seeing the new photo.)

-

image

+

image

Returning to your channel home page you will see that a post notifying others of your new profile pic has been automatically posted.

-

image

+

image

Compose a post

@@ -79,17 +79,17 @@ at the top of the channel "wall". Enter a message, and then drag-and-drop an ima file into the post editor text area (alternatively you can use the Attach file tool at the bottom).

-

image

+

image

Your image file will be automatically uploaded and stored in your cloud files, and a link will appear in the post window. Pressing the post preview button will allow you to preview your post before publishing it.

-

image

+

image

Pressing the lock button near the Submit button will open the Access Control List so you can specify exactly who can access this post.

-

image

+

image

Use an uploaded image as a channel cover photo

@@ -99,21 +99,21 @@ allows you to choose an existing photo for this purpose.

Visit your photos in the Photos app

-

image

+

image

Select the photo you wish to use and select Use as cover photo from the Photo Tools dropdown menu.

-

image

+

image

Crop the image using the photo editor and save your changes.

-

image

+

image

When you load your channel home page, you will first see the cover photo, and your channel page will fade in as you scroll down.

-

image

+

image

Make a connection

@@ -122,18 +122,18 @@ Making a connection is simple. If you do not already know how to reach a channel page, you might try a directory search by opening the Directory link on the right side of the top navbar.

-

image

+

image

You can connect directly from the directory entry using the Connect button there, or you can open the channel page first and press the Connect button below the profile photo.

-

image

+

image

After you connect you are immediately taken to the connection editor page, where you make some important decisions about what you plan to share with this channel.

-

image

+

image

The two important settings are

@@ -150,32 +150,32 @@ as they say, not a bug; it is a feature.

Privacy groups allow you to conveniently share items with groups of people. You can create whatever groups fit your needs by opening the Add privacy group link.

-

image

+

image

In this editor, you can switch between the existing privacy groups and see at a glance what channels are and are not members of the group. Selecting the icon of a channel in either box will move it to the in or out of the group.

-

image

+

image

When editing an individual channel's settings, you can set their privacy group membership using the widget on the left:

-

image

+

image

Connections are a mutual engagement. The channel you connect can choose to approve your connection. They will receive a notification that you connected

-

image

+

image

which takes them to their Connections editor page where they can choose to approve the connection or not.

-

image

+

image

After you approve a connection, it is a good idea to open the individual connection editor by pressing the edit button beside the Delete button.

-

image

+

image

\ No newline at end of file -- cgit v1.2.3 From 369dc295b12bc3fc4cc2ab50727bea277a44d91c Mon Sep 17 00:00:00 2001 From: Andrew Manning Date: Sun, 27 Nov 2016 14:48:06 -0700 Subject: Add some identity-aware parsing to HTML content using parseIdentityAwareHTML() --- doc/tutorials/personal_channel.html | 16 ++++++---------- 1 file changed, 6 insertions(+), 10 deletions(-) (limited to 'doc/tutorials/personal_channel.html') diff --git a/doc/tutorials/personal_channel.html b/doc/tutorials/personal_channel.html index f8dc4c628..37c9fc63a 100644 --- a/doc/tutorials/personal_channel.html +++ b/doc/tutorials/personal_channel.html @@ -1,16 +1,12 @@

Table of Contents

-- cgit v1.2.3 From b32bce9be22ca9c0c2b47e4a43282e9289c236ff Mon Sep 17 00:00:00 2001 From: Andrew Manning Date: Tue, 29 Nov 2016 22:08:19 -0500 Subject: Major changes to accordion nav menu. Table of contents auto-generated below the loaded page. Removed manual TOCs from individual pages. TOC uses jQuery plugin Sticky to remain visible when it would scroll out of view. --- doc/tutorials/personal_channel.html | 14 -------------- 1 file changed, 14 deletions(-) (limited to 'doc/tutorials/personal_channel.html') diff --git a/doc/tutorials/personal_channel.html b/doc/tutorials/personal_channel.html index 37c9fc63a..3b1fe40ba 100644 --- a/doc/tutorials/personal_channel.html +++ b/doc/tutorials/personal_channel.html @@ -1,17 +1,3 @@ -

Table of Contents

- - - -
- -

Personal Channel

This tutorial is intended to be followed in sequence as if you were setting up a channel for the first time. It introduces some of the tools and features related -- cgit v1.2.3 From 3d18f1447ef22b297415fe1e1ce50b885c6f2e43 Mon Sep 17 00:00:00 2001 From: Andrew Manning Date: Mon, 19 Dec 2016 22:20:45 -0500 Subject: More heading work and some content rearrangement. --- doc/tutorials/personal_channel.html | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) (limited to 'doc/tutorials/personal_channel.html') diff --git a/doc/tutorials/personal_channel.html b/doc/tutorials/personal_channel.html index 3b1fe40ba..f2ad87077 100644 --- a/doc/tutorials/personal_channel.html +++ b/doc/tutorials/personal_channel.html @@ -3,7 +3,7 @@ channel for the first time. It introduces some of the tools and features related to a personal channel in a natural way.

-

Create a new channel

+

Create a new channel

When you log in for the first time after registering, you must create a channel. (Alternatively you can load https://grid.reticu.li/new_channel)

@@ -15,7 +15,7 @@ Typically if this is a personal channel that represents you, select a So with a level of default privacy that you are comfortable with. If you are unsure, select Social - Restricted.

-

Configure your channel features

+

Configure your channel features

When your new channel is created you are directed to the channel settings page. Take the time to look around at all the settings pages to familiarize yourself with @@ -27,7 +27,7 @@ your selections.

imageimageimageimage

-

Add a profile photo

+

Add a profile photo

Navigate to your channel home by clicking the "Home" icon on the left side of the navbar, and then select the About tab to view your profile.

@@ -54,7 +54,7 @@ profile pic has been automatically posted.

image

-

Compose a post

+

Compose a post

Go to your channel home and open the post editor by pressing the Share textbox at the top of the channel "wall". Enter a message, and then drag-and-drop an image @@ -73,7 +73,7 @@ so you can specify exactly who can access this post.

image

-

Use an uploaded image as a channel cover photo

+

Use an uploaded image as a channel cover photo

One way to add some pizzazz your channel is to add a cover photo that visitors will see when they load your channel page. Hubzilla's integrated cloud file system @@ -97,7 +97,7 @@ channel page will fade in as you scroll down.

image

-

Make a connection

+

Make a connection

Making connections between channels to share things is what Hubzilla is all about. Making a connection is simple. If you do not already know how to reach a channel's home -- cgit v1.2.3