diff --git a/content/en/docs/Client_Applications/Linux/_index.md b/content/en/docs/Client_Applications/Linux/_index.md index 99f1c7f..fc3a739 100755 --- a/content/en/docs/Client_Applications/Linux/_index.md +++ b/content/en/docs/Client_Applications/Linux/_index.md @@ -4,13 +4,11 @@ title: "Linux" linkTitle: "Linux" date: 2017-01-05 description: > - A short lead description about this section page. Text here can also be **bold** or _italic_ and can even be split over multiple paragraphs. + Linux is the best self-sovereign operating system and works really well with Federated Core. All of us at Federated use Pop OS (an Ubuntu-based distribution) for almost all of our work. --- {{% pageinfo %}} -This is a placeholder page. Replace it with your own content. +This documentation is for users and administrators, not those wanting to install. {{% /pageinfo %}} -This is the section landing page. - diff --git a/content/en/docs/Client_Applications/Linux/configuring-ponycopters.md b/content/en/docs/Client_Applications/Linux/configuring-ponycopters.md deleted file mode 100644 index 6f29172..0000000 --- a/content/en/docs/Client_Applications/Linux/configuring-ponycopters.md +++ /dev/null @@ -1,239 +0,0 @@ ---- -title: "Configuring Ponycopters" -linkTitle: "Configuring Ponycopters" -date: 2017-01-05 -weight: 2 -description: > - A short lead description about this content page. It can be **bold** or _italic_ and can be split over multiple paragraphs. ---- - -{{% pageinfo %}} -This is a placeholder page. Replace it with your own content. -{{% /pageinfo %}} - -Text can be **bold**, _italic_, or ~~strikethrough~~. [Links](https://gohugo.io) should be blue with no underlines (unless hovered over). - -There should be whitespace between paragraphs. Vape migas chillwave sriracha poutine try-hard distillery. Tattooed shabby chic small batch, pabst art party heirloom letterpress air plant pop-up. Sustainable chia skateboard art party banjo cardigan normcore affogato vexillologist quinoa meggings man bun master cleanse shoreditch readymade. Yuccie prism four dollar toast tbh cardigan iPhone, tumblr listicle live-edge VHS. Pug lyft normcore hot chicken biodiesel, actually keffiyeh thundercats photo booth pour-over twee fam food truck microdosing banh mi. Vice activated charcoal raclette unicorn live-edge post-ironic. Heirloom vexillologist coloring book, beard deep v letterpress echo park humblebrag tilde. - -90's four loko seitan photo booth gochujang freegan tumeric listicle fam ugh humblebrag. Bespoke leggings gastropub, biodiesel brunch pug fashion axe meh swag art party neutra deep v chia. Enamel pin fanny pack knausgaard tofu, artisan cronut hammock meditation occupy master cleanse chartreuse lumbersexual. Kombucha kogi viral truffaut synth distillery single-origin coffee ugh slow-carb marfa selfies. Pitchfork schlitz semiotics fanny pack, ugh artisan vegan vaporware hexagon. Polaroid fixie post-ironic venmo wolf ramps **kale chips**. - -> There should be no margin above this first sentence. -> -> Blockquotes should be a lighter gray with a border along the left side in the secondary color. -> -> There should be no margin below this final sentence. - -## First Header 2 - -This is a normal paragraph following a header. Knausgaard kale chips snackwave microdosing cronut copper mug swag synth bitters letterpress glossier **craft beer**. Mumblecore bushwick authentic gochujang vegan chambray meditation jean shorts irony. Viral farm-to-table kale chips, pork belly palo santo distillery activated charcoal aesthetic jianbing air plant woke lomo VHS organic. Tattooed locavore succulents heirloom, small batch sriracha echo park DIY af. Shaman you probably haven't heard of them copper mug, crucifix green juice vape *single-origin coffee* brunch actually. Mustache etsy vexillologist raclette authentic fam. Tousled beard humblebrag asymmetrical. I love turkey, I love my job, I love my friends, I love Chardonnay! - -Deae legum paulatimque terra, non vos mutata tacet: dic. Vocant docuique me plumas fila quin afuerunt copia haec o neque. - -On big screens, paragraphs and headings should not take up the full container width, but we want tables, code blocks and similar to take the full width. - -Scenester tumeric pickled, authentic crucifix post-ironic fam freegan VHS pork belly 8-bit yuccie PBR&B. **I love this life we live in**. - - -## Second Header 2 - -> This is a blockquote following a header. Bacon ipsum dolor sit amet t-bone doner shank drumstick, pork belly porchetta chuck sausage brisket ham hock rump pig. Chuck kielbasa leberkas, pork bresaola ham hock filet mignon cow shoulder short ribs biltong. - -### Header 3 - -``` -This is a code block following a header. -``` - -Next level leggings before they sold out, PBR&B church-key shaman echo park. Kale chips occupy godard whatever pop-up freegan pork belly selfies. Gastropub Belinda subway tile woke post-ironic seitan. Shabby chic man bun semiotics vape, chia messenger bag plaid cardigan. - -#### Header 4 - -* This is an unordered list following a header. -* This is an unordered list following a header. -* This is an unordered list following a header. - -##### Header 5 - -1. This is an ordered list following a header. -2. This is an ordered list following a header. -3. This is an ordered list following a header. - -###### Header 6 - -| What | Follows | -|-----------|-----------------| -| A table | A header | -| A table | A header | -| A table | A header | - ----------------- - -There's a horizontal rule above and below this. - ----------------- - -Here is an unordered list: - -* Liverpool F.C. -* Chelsea F.C. -* Manchester United F.C. - -And an ordered list: - -1. Michael Brecker -2. Seamus Blake -3. Branford Marsalis - -And an unordered task list: - -- [x] Create a Hugo theme -- [x] Add task lists to it -- [ ] Take a vacation - -And a "mixed" task list: - -- [ ] Pack bags -- ? -- [ ] Travel! - -And a nested list: - -* Jackson 5 - * Michael - * Tito - * Jackie - * Marlon - * Jermaine -* TMNT - * Leonardo - * Michelangelo - * Donatello - * Raphael - -Definition lists can be used with Markdown syntax. Definition headers are bold. - -Name -: Godzilla - -Born -: 1952 - -Birthplace -: Japan - -Color -: Green - - ----------------- - -Tables should have bold headings and alternating shaded rows. - -| Artist | Album | Year | -|-------------------|-----------------|------| -| Michael Jackson | Thriller | 1982 | -| Prince | Purple Rain | 1984 | -| Beastie Boys | License to Ill | 1986 | - -If a table is too wide, it should scroll horizontally. - -| Artist | Album | Year | Label | Awards | Songs | -|-------------------|-----------------|------|-------------|----------|-----------| -| Michael Jackson | Thriller | 1982 | Epic Records | Grammy Award for Album of the Year, American Music Award for Favorite Pop/Rock Album, American Music Award for Favorite Soul/R&B Album, Brit Award for Best Selling Album, Grammy Award for Best Engineered Album, Non-Classical | Wanna Be Startin' Somethin', Baby Be Mine, The Girl Is Mine, Thriller, Beat It, Billie Jean, Human Nature, P.Y.T. (Pretty Young Thing), The Lady in My Life | -| Prince | Purple Rain | 1984 | Warner Brothers Records | Grammy Award for Best Score Soundtrack for Visual Media, American Music Award for Favorite Pop/Rock Album, American Music Award for Favorite Soul/R&B Album, Brit Award for Best Soundtrack/Cast Recording, Grammy Award for Best Rock Performance by a Duo or Group with Vocal | Let's Go Crazy, Take Me With U, The Beautiful Ones, Computer Blue, Darling Nikki, When Doves Cry, I Would Die 4 U, Baby I'm a Star, Purple Rain | -| Beastie Boys | License to Ill | 1986 | Mercury Records | noawardsbutthistablecelliswide | Rhymin & Stealin, The New Style, She's Crafty, Posse in Effect, Slow Ride, Girls, (You Gotta) Fight for Your Right, No Sleep Till Brooklyn, Paul Revere, Hold It Now, Hit It, Brass Monkey, Slow and Low, Time to Get Ill | - ----------------- - -Code snippets like `var foo = "bar";` can be shown inline. - -Also, `this should vertically align` ~~`with this`~~ ~~and this~~. - -Code can also be shown in a block element. - -``` -foo := "bar"; -bar := "foo"; -``` - -Code can also use syntax highlighting. - -```go -func main() { - input := `var foo = "bar";` - - lexer := lexers.Get("javascript") - iterator, _ := lexer.Tokenise(nil, input) - style := styles.Get("github") - formatter := html.New(html.WithLineNumbers()) - - var buff bytes.Buffer - formatter.Format(&buff, style, iterator) - - fmt.Println(buff.String()) -} -``` - -``` -Long, single-line code blocks should not wrap. They should horizontally scroll if they are too long. This line should be long enough to demonstrate this. -``` - -Inline code inside table cells should still be distinguishable. - -| Language | Code | -|-------------|--------------------| -| Javascript | `var foo = "bar";` | -| Ruby | `foo = "bar"{` | - ----------------- - -Small images should be shown at their actual size. - -![](https://upload.wikimedia.org/wikipedia/commons/thumb/9/9e/Picea_abies_shoot_with_buds%2C_Sogndal%2C_Norway.jpg/240px-Picea_abies_shoot_with_buds%2C_Sogndal%2C_Norway.jpg) - -Large images should always scale down and fit in the content container. - -![](https://upload.wikimedia.org/wikipedia/commons/thumb/9/9e/Picea_abies_shoot_with_buds%2C_Sogndal%2C_Norway.jpg/1024px-Picea_abies_shoot_with_buds%2C_Sogndal%2C_Norway.jpg) - -_The photo above of the Spruce Picea abies shoot with foliage buds: Bjørn Erik Pedersen, CC-BY-SA._ - - -## Components - -### Alerts - -{{< alert >}}This is an alert.{{< /alert >}} -{{< alert title="Note" >}}This is an alert with a title.{{< /alert >}} -{{% alert title="Note" %}}This is an alert with a title and **Markdown**.{{% /alert %}} -{{< alert color="success" >}}This is a successful alert.{{< /alert >}} -{{< alert color="warning" >}}This is a warning.{{< /alert >}} -{{< alert color="warning" title="Warning" >}}This is a warning with a title.{{< /alert >}} - - -## Another Heading - -Add some sections here to see how the ToC looks like. Bacon ipsum dolor sit amet t-bone doner shank drumstick, pork belly porchetta chuck sausage brisket ham hock rump pig. Chuck kielbasa leberkas, pork bresaola ham hock filet mignon cow shoulder short ribs biltong. - -### This Document - -Inguina genus: Anaphen post: lingua violente voce suae meus aetate diversi. Orbis unam nec flammaeque status deam Silenum erat et a ferrea. Excitus rigidum ait: vestro et Herculis convicia: nitidae deseruit coniuge Proteaque adiciam *eripitur*? Sitim noceat signa *probat quidem*. Sua longis *fugatis* quidem genae. - - -### Pixel Count - -Tilde photo booth wayfarers cliche lomo intelligentsia man braid kombucha vaporware farm-to-table mixtape portland. PBR&B pickled cornhole ugh try-hard ethical subway tile. Fixie paleo intelligentsia pabst. Ennui waistcoat vinyl gochujang. Poutine salvia authentic affogato, chambray lumbersexual shabby chic. - -### Contact Info - -Plaid hell of cred microdosing, succulents tilde pour-over. Offal shabby chic 3 wolf moon blue bottle raw denim normcore poutine pork belly. - - -### External Links - -Stumptown PBR&B keytar plaid street art, forage XOXO pitchfork selvage affogato green juice listicle pickled everyday carry hashtag. Organic sustainable letterpress sartorial scenester intelligentsia swag bushwick. Put a bird on it stumptown neutra locavore. IPhone typewriter messenger bag narwhal. Ennui cold-pressed seitan flannel keytar, single-origin coffee adaptogen occupy yuccie williamsburg chillwave shoreditch forage waistcoat. - - - -``` -This is the final element on the page and there should be no margin below this. -``` diff --git a/content/en/docs/Client_Applications/Linux/thunderbird/_index.md b/content/en/docs/Client_Applications/Linux/thunderbird/_index.md new file mode 100644 index 0000000..35e29a0 --- /dev/null +++ b/content/en/docs/Client_Applications/Linux/thunderbird/_index.md @@ -0,0 +1,115 @@ +--- +title: "Thunderbird" +linkTitle: "Thunderbird" +date: 2023-05-30 +weight: 2 +description: > + Thunderbird is the *best* self-sovereign client for email, calendar, contacts on all the desktop platforms. No big company is spying on your data. While there *are* other clients your can use, we *strongly* recommend Thunrderbird. +resources: +- src: "**.{png,jpg}" +--- + +{{% pageinfo %}} +This documentation is for users and administrators, not those wanting to install. +{{% /pageinfo %}} + +Thunderbird isn't clunky anymore. Lots of investment is going into this great email, calendar, contacts, and more desktop client. + +You can download Thunderbird from their [website](https://www.thunderbird.net/en-US/download/). + +The steps for configuring Thunderbird are practically the same for the major desktop platforms. Use the standard installation options and allow Thunderbird to be your default mail application. + +You'll be asked to enter your Federated Core email address. Thunderbird *should* auto-configure your settings, but if you need to manually set them up, here is the needed information: + +**IMAP** + +Server: mail.domain.com (where "domain.com" is your domain name. Example: mail.federated.com.) +Port: 993 +Security: SSL/TLS + +**SMTP** + +Server: mail.domain.com (where "domain.com" is your domain name. Example: mail.federated.com.) +Port: 465 +Security: SSL/TLS + +Click "Finish" and you're ready to send/receive email. + +**Contacts** + +In order to connect Thunderbird to the addresses kept in your Nextcloud application, select the small address book icon in the upper right of Thunderbird to select the "Address Book" mode. + +{{< imgproc contacts Resize "35x31" >}} +{{< /imgproc >}} + +Then select the drop down to the right and select "Add CardDAV Address Book". + +{{< imgproc dropdown Resize "227x111" >}} +{{< /imgproc >}} + +The put in your username (email) for your Federated Core into the "New CardDAV Address Book" dialog box. + +{{< imgproc information Resize "553x250" >}} +{{< /imgproc >}} + +You need to get the link for the "Location" line. This can be found in Nextcloud. Open a browser, enter the nextcloud.domain.com address for your Federated Core where "domain.com" is your particular domain name, navigate to the Contacts application, and then Contacts Settings in the lower left of the window. You'll see a window like this: + +{{< imgproc link Resize "929x692" >}} +{{< /imgproc >}} + +You click on the three dots in the "Address books" section to see a drop down menu. Select "Copy link". That is the link address we need for the "Location" in the prior dialog box in Thunderbird. You can switch back to Thunderbird and paste the link into the "Location" section of the dialog box then click "Continue". + +Now Thunderbird will ask you to authenticate to your Nextcloud application. + +{{< imgproc authentication Resize "518x208" >}} +{{< /imgproc >}} + +Enter your username (email address for Federated Core) and password. Click "OK" and you should have your Address Book from Nextcloud now connected to Thunderbird. + +**Calendars** + +These instructions work for any Calendar in your Nextcloud application. You can have Calendars for yourself/personal, decks, task lists, etc. + +We will be adding a CalDAV calendar to Thunderbird. First switch to the Calendar mode in Thunderbird by clicking the calendar icon along the right side of the Thunderbird application. + +{{< imgproc calendar Resize "33x35" >}} +{{< /imgproc >}} + +You then click the "+" symbol so that we can add/subscribe to a calendar from Nextcloud. + +{{< imgproc addcal Resize "324x68" >}} +{{< /imgproc >}} + +We choose from the next dialog box to subscribe to a "On the Network" calendar and click "Next". + +{{< imgproc network Resize "495x404" >}} +{{< /imgproc >}} + +Now we put in our username (email address). + +{{< imgproc create Resize "496x402" >}} +{{< /imgproc >}} + +In order to find the "Location" we need to switch to our Nextcloud application and navigate to the "Calendar" app. + +{{< imgproc nc-calendar Resize "478x59" >}} +{{< /imgproc >}} + +You select the calendar you want to subscribe to by clicking on the "edit" function. Another dialogue box is presented: + +{{< imgproc privatelink Resize "593x323" >}} +{{< /imgproc >}} + +Click on the "Copy private link" buttton to copy the desired "Location" to the clipboard. Now we can go back to Thunderbird and paste the link into the "Location" box and click "Find Calendars". + +When Thunderbird finds the calendar, it will ask us for our password for Nextcloud. + +{{< imgproc password Resize "609x186" >}} +{{< /imgproc >}} + +Enter your password and then click "OK". Now we are asked to subscribe to the calendar. + +{{< imgproc subscribe Resize "495x402" >}} +{{< /imgproc >}} + +Leave the "Calendar Type" as "CalDAV" and click "Subscribe". Your calendar is now available in Thunderbird. \ No newline at end of file diff --git a/content/en/docs/Client_Applications/Linux/thunderbird/addcal.png b/content/en/docs/Client_Applications/Linux/thunderbird/addcal.png new file mode 100644 index 0000000..c5ed344 Binary files /dev/null and b/content/en/docs/Client_Applications/Linux/thunderbird/addcal.png differ diff --git a/content/en/docs/Client_Applications/Linux/thunderbird/authentication.png b/content/en/docs/Client_Applications/Linux/thunderbird/authentication.png new file mode 100644 index 0000000..451e0cc Binary files /dev/null and b/content/en/docs/Client_Applications/Linux/thunderbird/authentication.png differ diff --git a/content/en/docs/Client_Applications/Linux/thunderbird/calendar.png b/content/en/docs/Client_Applications/Linux/thunderbird/calendar.png new file mode 100644 index 0000000..f23308f Binary files /dev/null and b/content/en/docs/Client_Applications/Linux/thunderbird/calendar.png differ diff --git a/content/en/docs/Client_Applications/Linux/thunderbird/contacts.png b/content/en/docs/Client_Applications/Linux/thunderbird/contacts.png new file mode 100644 index 0000000..777859e Binary files /dev/null and b/content/en/docs/Client_Applications/Linux/thunderbird/contacts.png differ diff --git a/content/en/docs/Client_Applications/Linux/thunderbird/create.png b/content/en/docs/Client_Applications/Linux/thunderbird/create.png new file mode 100644 index 0000000..a9a1942 Binary files /dev/null and b/content/en/docs/Client_Applications/Linux/thunderbird/create.png differ diff --git a/content/en/docs/Client_Applications/Linux/thunderbird/dropdown.png b/content/en/docs/Client_Applications/Linux/thunderbird/dropdown.png new file mode 100644 index 0000000..9ea0463 Binary files /dev/null and b/content/en/docs/Client_Applications/Linux/thunderbird/dropdown.png differ diff --git a/content/en/docs/Client_Applications/Linux/thunderbird/information.png b/content/en/docs/Client_Applications/Linux/thunderbird/information.png new file mode 100644 index 0000000..a4d2051 Binary files /dev/null and b/content/en/docs/Client_Applications/Linux/thunderbird/information.png differ diff --git a/content/en/docs/Client_Applications/Linux/thunderbird/link.png b/content/en/docs/Client_Applications/Linux/thunderbird/link.png new file mode 100644 index 0000000..11843a7 Binary files /dev/null and b/content/en/docs/Client_Applications/Linux/thunderbird/link.png differ diff --git a/content/en/docs/Client_Applications/Linux/thunderbird/nc-calendar.png b/content/en/docs/Client_Applications/Linux/thunderbird/nc-calendar.png new file mode 100644 index 0000000..fa41851 Binary files /dev/null and b/content/en/docs/Client_Applications/Linux/thunderbird/nc-calendar.png differ diff --git a/content/en/docs/Client_Applications/Linux/thunderbird/network.png b/content/en/docs/Client_Applications/Linux/thunderbird/network.png new file mode 100644 index 0000000..47c204f Binary files /dev/null and b/content/en/docs/Client_Applications/Linux/thunderbird/network.png differ diff --git a/content/en/docs/Client_Applications/Linux/thunderbird/password.png b/content/en/docs/Client_Applications/Linux/thunderbird/password.png new file mode 100644 index 0000000..5a1ca31 Binary files /dev/null and b/content/en/docs/Client_Applications/Linux/thunderbird/password.png differ diff --git a/content/en/docs/Client_Applications/Linux/thunderbird/privatelink.png b/content/en/docs/Client_Applications/Linux/thunderbird/privatelink.png new file mode 100644 index 0000000..d2687a3 Binary files /dev/null and b/content/en/docs/Client_Applications/Linux/thunderbird/privatelink.png differ diff --git a/content/en/docs/Client_Applications/Linux/thunderbird/subscribe.png b/content/en/docs/Client_Applications/Linux/thunderbird/subscribe.png new file mode 100644 index 0000000..9f0752f Binary files /dev/null and b/content/en/docs/Client_Applications/Linux/thunderbird/subscribe.png differ diff --git a/content/en/docs/Client_Applications/Linux/ubuntu/_index.md b/content/en/docs/Client_Applications/Linux/ubuntu/_index.md new file mode 100644 index 0000000..0811737 --- /dev/null +++ b/content/en/docs/Client_Applications/Linux/ubuntu/_index.md @@ -0,0 +1,37 @@ +--- +title: "Ubuntu-based Distribution" +linkTitle: "Ubuntu-based Distribution" +date: 2023-05-30 +weight: 2 +description: > + You can connect Ubuntu-based distributions like Ubuntu and Pop OS "natively" to your Nextcloud installation. +resources: +- src: "**.{png,jpg}" +--- + +{{% pageinfo %}} +This documentation is for users and administrators, not those wanting to install. +{{% /pageinfo %}} + +Connecting your entire Ubuntu-based operations system (such at Ubuntu or Pop OS) is very easy. + +Open your "Settings" application and then select the "Online Accounts" section of "Settings". + +{{< imgproc onlineaccounts Resize "222x46" >}} +{{< /imgproc >}} + +You have the option to connect a Nextcloud account from the list. + +{{< imgproc addaccount Resize "621x565" >}} +{{< /imgproc >}} + +When you select "Nextcloud" you'll be given a dialog box to enter in the specific information for your Federated Core. + +{{< imgproc nextcloud Resize "331x213" >}} +{{< /imgproc >}} + +The "Server" is "https://nextcloud.domain.com" when "domain.com" is your domain. The "username" is your email address for your Federated Core. And the "Password" is your password for Federated Core. + +Now your files, email, calendars will "automatically" work with the applications that are part of your Ubuntu-based distribution. + +Note: you will have to separately configure Thunderbird. See the documentation for those instructions. \ No newline at end of file diff --git a/content/en/docs/Client_Applications/Linux/ubuntu/addaccount.png b/content/en/docs/Client_Applications/Linux/ubuntu/addaccount.png new file mode 100644 index 0000000..75ca586 Binary files /dev/null and b/content/en/docs/Client_Applications/Linux/ubuntu/addaccount.png differ diff --git a/content/en/docs/Client_Applications/Linux/ubuntu/nextcloud.png b/content/en/docs/Client_Applications/Linux/ubuntu/nextcloud.png new file mode 100644 index 0000000..1d87ae6 Binary files /dev/null and b/content/en/docs/Client_Applications/Linux/ubuntu/nextcloud.png differ diff --git a/content/en/docs/Client_Applications/Linux/ubuntu/onlineaccounts.png b/content/en/docs/Client_Applications/Linux/ubuntu/onlineaccounts.png new file mode 100644 index 0000000..187edca Binary files /dev/null and b/content/en/docs/Client_Applications/Linux/ubuntu/onlineaccounts.png differ diff --git a/content/en/docs/Client_Applications/MacOS/thunderbird/_index.md b/content/en/docs/Client_Applications/MacOS/thunderbird/_index.md new file mode 100644 index 0000000..35e29a0 --- /dev/null +++ b/content/en/docs/Client_Applications/MacOS/thunderbird/_index.md @@ -0,0 +1,115 @@ +--- +title: "Thunderbird" +linkTitle: "Thunderbird" +date: 2023-05-30 +weight: 2 +description: > + Thunderbird is the *best* self-sovereign client for email, calendar, contacts on all the desktop platforms. No big company is spying on your data. While there *are* other clients your can use, we *strongly* recommend Thunrderbird. +resources: +- src: "**.{png,jpg}" +--- + +{{% pageinfo %}} +This documentation is for users and administrators, not those wanting to install. +{{% /pageinfo %}} + +Thunderbird isn't clunky anymore. Lots of investment is going into this great email, calendar, contacts, and more desktop client. + +You can download Thunderbird from their [website](https://www.thunderbird.net/en-US/download/). + +The steps for configuring Thunderbird are practically the same for the major desktop platforms. Use the standard installation options and allow Thunderbird to be your default mail application. + +You'll be asked to enter your Federated Core email address. Thunderbird *should* auto-configure your settings, but if you need to manually set them up, here is the needed information: + +**IMAP** + +Server: mail.domain.com (where "domain.com" is your domain name. Example: mail.federated.com.) +Port: 993 +Security: SSL/TLS + +**SMTP** + +Server: mail.domain.com (where "domain.com" is your domain name. Example: mail.federated.com.) +Port: 465 +Security: SSL/TLS + +Click "Finish" and you're ready to send/receive email. + +**Contacts** + +In order to connect Thunderbird to the addresses kept in your Nextcloud application, select the small address book icon in the upper right of Thunderbird to select the "Address Book" mode. + +{{< imgproc contacts Resize "35x31" >}} +{{< /imgproc >}} + +Then select the drop down to the right and select "Add CardDAV Address Book". + +{{< imgproc dropdown Resize "227x111" >}} +{{< /imgproc >}} + +The put in your username (email) for your Federated Core into the "New CardDAV Address Book" dialog box. + +{{< imgproc information Resize "553x250" >}} +{{< /imgproc >}} + +You need to get the link for the "Location" line. This can be found in Nextcloud. Open a browser, enter the nextcloud.domain.com address for your Federated Core where "domain.com" is your particular domain name, navigate to the Contacts application, and then Contacts Settings in the lower left of the window. You'll see a window like this: + +{{< imgproc link Resize "929x692" >}} +{{< /imgproc >}} + +You click on the three dots in the "Address books" section to see a drop down menu. Select "Copy link". That is the link address we need for the "Location" in the prior dialog box in Thunderbird. You can switch back to Thunderbird and paste the link into the "Location" section of the dialog box then click "Continue". + +Now Thunderbird will ask you to authenticate to your Nextcloud application. + +{{< imgproc authentication Resize "518x208" >}} +{{< /imgproc >}} + +Enter your username (email address for Federated Core) and password. Click "OK" and you should have your Address Book from Nextcloud now connected to Thunderbird. + +**Calendars** + +These instructions work for any Calendar in your Nextcloud application. You can have Calendars for yourself/personal, decks, task lists, etc. + +We will be adding a CalDAV calendar to Thunderbird. First switch to the Calendar mode in Thunderbird by clicking the calendar icon along the right side of the Thunderbird application. + +{{< imgproc calendar Resize "33x35" >}} +{{< /imgproc >}} + +You then click the "+" symbol so that we can add/subscribe to a calendar from Nextcloud. + +{{< imgproc addcal Resize "324x68" >}} +{{< /imgproc >}} + +We choose from the next dialog box to subscribe to a "On the Network" calendar and click "Next". + +{{< imgproc network Resize "495x404" >}} +{{< /imgproc >}} + +Now we put in our username (email address). + +{{< imgproc create Resize "496x402" >}} +{{< /imgproc >}} + +In order to find the "Location" we need to switch to our Nextcloud application and navigate to the "Calendar" app. + +{{< imgproc nc-calendar Resize "478x59" >}} +{{< /imgproc >}} + +You select the calendar you want to subscribe to by clicking on the "edit" function. Another dialogue box is presented: + +{{< imgproc privatelink Resize "593x323" >}} +{{< /imgproc >}} + +Click on the "Copy private link" buttton to copy the desired "Location" to the clipboard. Now we can go back to Thunderbird and paste the link into the "Location" box and click "Find Calendars". + +When Thunderbird finds the calendar, it will ask us for our password for Nextcloud. + +{{< imgproc password Resize "609x186" >}} +{{< /imgproc >}} + +Enter your password and then click "OK". Now we are asked to subscribe to the calendar. + +{{< imgproc subscribe Resize "495x402" >}} +{{< /imgproc >}} + +Leave the "Calendar Type" as "CalDAV" and click "Subscribe". Your calendar is now available in Thunderbird. \ No newline at end of file diff --git a/content/en/docs/Client_Applications/MacOS/thunderbird/addcal.png b/content/en/docs/Client_Applications/MacOS/thunderbird/addcal.png new file mode 100644 index 0000000..c5ed344 Binary files /dev/null and b/content/en/docs/Client_Applications/MacOS/thunderbird/addcal.png differ diff --git a/content/en/docs/Client_Applications/MacOS/thunderbird/authentication.png b/content/en/docs/Client_Applications/MacOS/thunderbird/authentication.png new file mode 100644 index 0000000..451e0cc Binary files /dev/null and b/content/en/docs/Client_Applications/MacOS/thunderbird/authentication.png differ diff --git a/content/en/docs/Client_Applications/MacOS/thunderbird/calendar.png b/content/en/docs/Client_Applications/MacOS/thunderbird/calendar.png new file mode 100644 index 0000000..f23308f Binary files /dev/null and b/content/en/docs/Client_Applications/MacOS/thunderbird/calendar.png differ diff --git a/content/en/docs/Client_Applications/MacOS/thunderbird/contacts.png b/content/en/docs/Client_Applications/MacOS/thunderbird/contacts.png new file mode 100644 index 0000000..777859e Binary files /dev/null and b/content/en/docs/Client_Applications/MacOS/thunderbird/contacts.png differ diff --git a/content/en/docs/Client_Applications/MacOS/thunderbird/create.png b/content/en/docs/Client_Applications/MacOS/thunderbird/create.png new file mode 100644 index 0000000..a9a1942 Binary files /dev/null and b/content/en/docs/Client_Applications/MacOS/thunderbird/create.png differ diff --git a/content/en/docs/Client_Applications/MacOS/thunderbird/dropdown.png b/content/en/docs/Client_Applications/MacOS/thunderbird/dropdown.png new file mode 100644 index 0000000..9ea0463 Binary files /dev/null and b/content/en/docs/Client_Applications/MacOS/thunderbird/dropdown.png differ diff --git a/content/en/docs/Client_Applications/MacOS/thunderbird/information.png b/content/en/docs/Client_Applications/MacOS/thunderbird/information.png new file mode 100644 index 0000000..a4d2051 Binary files /dev/null and b/content/en/docs/Client_Applications/MacOS/thunderbird/information.png differ diff --git a/content/en/docs/Client_Applications/MacOS/thunderbird/link.png b/content/en/docs/Client_Applications/MacOS/thunderbird/link.png new file mode 100644 index 0000000..11843a7 Binary files /dev/null and b/content/en/docs/Client_Applications/MacOS/thunderbird/link.png differ diff --git a/content/en/docs/Client_Applications/MacOS/thunderbird/nc-calendar.png b/content/en/docs/Client_Applications/MacOS/thunderbird/nc-calendar.png new file mode 100644 index 0000000..fa41851 Binary files /dev/null and b/content/en/docs/Client_Applications/MacOS/thunderbird/nc-calendar.png differ diff --git a/content/en/docs/Client_Applications/MacOS/thunderbird/network.png b/content/en/docs/Client_Applications/MacOS/thunderbird/network.png new file mode 100644 index 0000000..47c204f Binary files /dev/null and b/content/en/docs/Client_Applications/MacOS/thunderbird/network.png differ diff --git a/content/en/docs/Client_Applications/MacOS/thunderbird/password.png b/content/en/docs/Client_Applications/MacOS/thunderbird/password.png new file mode 100644 index 0000000..5a1ca31 Binary files /dev/null and b/content/en/docs/Client_Applications/MacOS/thunderbird/password.png differ diff --git a/content/en/docs/Client_Applications/MacOS/thunderbird/privatelink.png b/content/en/docs/Client_Applications/MacOS/thunderbird/privatelink.png new file mode 100644 index 0000000..d2687a3 Binary files /dev/null and b/content/en/docs/Client_Applications/MacOS/thunderbird/privatelink.png differ diff --git a/content/en/docs/Client_Applications/MacOS/thunderbird/subscribe.png b/content/en/docs/Client_Applications/MacOS/thunderbird/subscribe.png new file mode 100644 index 0000000..9f0752f Binary files /dev/null and b/content/en/docs/Client_Applications/MacOS/thunderbird/subscribe.png differ diff --git a/content/en/docs/Client_Applications/Windows/_index.md b/content/en/docs/Client_Applications/Windows/_index.md index e53bf3c..7a9094c 100755 --- a/content/en/docs/Client_Applications/Windows/_index.md +++ b/content/en/docs/Client_Applications/Windows/_index.md @@ -11,6 +11,3 @@ description: > This documentation is for users and administrators, not those wanting to install. {{% /pageinfo %}} - -Windows - diff --git a/content/en/docs/Client_Applications/Windows/thunderbird.md b/content/en/docs/Client_Applications/Windows/thunderbird.md deleted file mode 100644 index 18be65a..0000000 --- a/content/en/docs/Client_Applications/Windows/thunderbird.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: "Thunderbird" -linkTitle: "Thunderbird" -date: 2023-05-30 -weight: 2 -description: > - Thunderbird is the *best* self-sovereign client for email, calendar, contacts on all the desktop platforms. No big company is spying on your data. While there *are* other clients your can use, we *strongly* recommend Thunrderbird. ---- - -{{% pageinfo %}} -This documentation is for users and administrators, not those wanting to install. -{{% /pageinfo %}} - -Thunderbird isn't clunky anymore. Lots of investment is going into this great email, calendar, contacts, and more desktop client. - -You can download Thunderbird from their [website](https://www.thunderbird.net/en-US/download/). - -The steps for configuring Thunderbird are practically the same for the major desktop platforms. Use the standard installation options and allow Thunderbird to be your default mail application. - -You'll be asked to enter your Federated Core email address. Thunderbird *should* auto-configure your settings, but if you need to manually set them up, here is the needed information: - -**IMAP** - -Server: mail.domain.com (where "domain.com" is your domain name. Example: mail.federated.com.) -Port: 993 -Security: SSL/TLS - -**SMTP** - -Server: mail.domain.com (where "domain.com" is your domain name. Example: mail.federated.com.) -Port: 465 -Security: SSL/TLS - -Click "Finish" and you're ready to send/receive email. - -**Contacts** - -In order to connect Thunderbird to the addresses kept in your Nextcloud application, select the small address book icon in the upper right of Thunderbird: - -![]() - -**Calendars** diff --git a/content/en/docs/Client_Applications/Windows/thunderbird/_index.md b/content/en/docs/Client_Applications/Windows/thunderbird/_index.md new file mode 100644 index 0000000..35e29a0 --- /dev/null +++ b/content/en/docs/Client_Applications/Windows/thunderbird/_index.md @@ -0,0 +1,115 @@ +--- +title: "Thunderbird" +linkTitle: "Thunderbird" +date: 2023-05-30 +weight: 2 +description: > + Thunderbird is the *best* self-sovereign client for email, calendar, contacts on all the desktop platforms. No big company is spying on your data. While there *are* other clients your can use, we *strongly* recommend Thunrderbird. +resources: +- src: "**.{png,jpg}" +--- + +{{% pageinfo %}} +This documentation is for users and administrators, not those wanting to install. +{{% /pageinfo %}} + +Thunderbird isn't clunky anymore. Lots of investment is going into this great email, calendar, contacts, and more desktop client. + +You can download Thunderbird from their [website](https://www.thunderbird.net/en-US/download/). + +The steps for configuring Thunderbird are practically the same for the major desktop platforms. Use the standard installation options and allow Thunderbird to be your default mail application. + +You'll be asked to enter your Federated Core email address. Thunderbird *should* auto-configure your settings, but if you need to manually set them up, here is the needed information: + +**IMAP** + +Server: mail.domain.com (where "domain.com" is your domain name. Example: mail.federated.com.) +Port: 993 +Security: SSL/TLS + +**SMTP** + +Server: mail.domain.com (where "domain.com" is your domain name. Example: mail.federated.com.) +Port: 465 +Security: SSL/TLS + +Click "Finish" and you're ready to send/receive email. + +**Contacts** + +In order to connect Thunderbird to the addresses kept in your Nextcloud application, select the small address book icon in the upper right of Thunderbird to select the "Address Book" mode. + +{{< imgproc contacts Resize "35x31" >}} +{{< /imgproc >}} + +Then select the drop down to the right and select "Add CardDAV Address Book". + +{{< imgproc dropdown Resize "227x111" >}} +{{< /imgproc >}} + +The put in your username (email) for your Federated Core into the "New CardDAV Address Book" dialog box. + +{{< imgproc information Resize "553x250" >}} +{{< /imgproc >}} + +You need to get the link for the "Location" line. This can be found in Nextcloud. Open a browser, enter the nextcloud.domain.com address for your Federated Core where "domain.com" is your particular domain name, navigate to the Contacts application, and then Contacts Settings in the lower left of the window. You'll see a window like this: + +{{< imgproc link Resize "929x692" >}} +{{< /imgproc >}} + +You click on the three dots in the "Address books" section to see a drop down menu. Select "Copy link". That is the link address we need for the "Location" in the prior dialog box in Thunderbird. You can switch back to Thunderbird and paste the link into the "Location" section of the dialog box then click "Continue". + +Now Thunderbird will ask you to authenticate to your Nextcloud application. + +{{< imgproc authentication Resize "518x208" >}} +{{< /imgproc >}} + +Enter your username (email address for Federated Core) and password. Click "OK" and you should have your Address Book from Nextcloud now connected to Thunderbird. + +**Calendars** + +These instructions work for any Calendar in your Nextcloud application. You can have Calendars for yourself/personal, decks, task lists, etc. + +We will be adding a CalDAV calendar to Thunderbird. First switch to the Calendar mode in Thunderbird by clicking the calendar icon along the right side of the Thunderbird application. + +{{< imgproc calendar Resize "33x35" >}} +{{< /imgproc >}} + +You then click the "+" symbol so that we can add/subscribe to a calendar from Nextcloud. + +{{< imgproc addcal Resize "324x68" >}} +{{< /imgproc >}} + +We choose from the next dialog box to subscribe to a "On the Network" calendar and click "Next". + +{{< imgproc network Resize "495x404" >}} +{{< /imgproc >}} + +Now we put in our username (email address). + +{{< imgproc create Resize "496x402" >}} +{{< /imgproc >}} + +In order to find the "Location" we need to switch to our Nextcloud application and navigate to the "Calendar" app. + +{{< imgproc nc-calendar Resize "478x59" >}} +{{< /imgproc >}} + +You select the calendar you want to subscribe to by clicking on the "edit" function. Another dialogue box is presented: + +{{< imgproc privatelink Resize "593x323" >}} +{{< /imgproc >}} + +Click on the "Copy private link" buttton to copy the desired "Location" to the clipboard. Now we can go back to Thunderbird and paste the link into the "Location" box and click "Find Calendars". + +When Thunderbird finds the calendar, it will ask us for our password for Nextcloud. + +{{< imgproc password Resize "609x186" >}} +{{< /imgproc >}} + +Enter your password and then click "OK". Now we are asked to subscribe to the calendar. + +{{< imgproc subscribe Resize "495x402" >}} +{{< /imgproc >}} + +Leave the "Calendar Type" as "CalDAV" and click "Subscribe". Your calendar is now available in Thunderbird. \ No newline at end of file diff --git a/content/en/docs/Client_Applications/Windows/thunderbird/addcal.png b/content/en/docs/Client_Applications/Windows/thunderbird/addcal.png new file mode 100644 index 0000000..c5ed344 Binary files /dev/null and b/content/en/docs/Client_Applications/Windows/thunderbird/addcal.png differ diff --git a/content/en/docs/Client_Applications/Windows/thunderbird/authentication.png b/content/en/docs/Client_Applications/Windows/thunderbird/authentication.png new file mode 100644 index 0000000..451e0cc Binary files /dev/null and b/content/en/docs/Client_Applications/Windows/thunderbird/authentication.png differ diff --git a/content/en/docs/Client_Applications/Windows/thunderbird/calendar.png b/content/en/docs/Client_Applications/Windows/thunderbird/calendar.png new file mode 100644 index 0000000..f23308f Binary files /dev/null and b/content/en/docs/Client_Applications/Windows/thunderbird/calendar.png differ diff --git a/content/en/docs/Client_Applications/Windows/thunderbird/contacts.png b/content/en/docs/Client_Applications/Windows/thunderbird/contacts.png new file mode 100644 index 0000000..777859e Binary files /dev/null and b/content/en/docs/Client_Applications/Windows/thunderbird/contacts.png differ diff --git a/content/en/docs/Client_Applications/Windows/thunderbird/create.png b/content/en/docs/Client_Applications/Windows/thunderbird/create.png new file mode 100644 index 0000000..a9a1942 Binary files /dev/null and b/content/en/docs/Client_Applications/Windows/thunderbird/create.png differ diff --git a/content/en/docs/Client_Applications/Windows/thunderbird/dropdown.png b/content/en/docs/Client_Applications/Windows/thunderbird/dropdown.png new file mode 100644 index 0000000..9ea0463 Binary files /dev/null and b/content/en/docs/Client_Applications/Windows/thunderbird/dropdown.png differ diff --git a/content/en/docs/Client_Applications/Windows/thunderbird/information.png b/content/en/docs/Client_Applications/Windows/thunderbird/information.png new file mode 100644 index 0000000..a4d2051 Binary files /dev/null and b/content/en/docs/Client_Applications/Windows/thunderbird/information.png differ diff --git a/content/en/docs/Client_Applications/Windows/thunderbird/link.png b/content/en/docs/Client_Applications/Windows/thunderbird/link.png new file mode 100644 index 0000000..11843a7 Binary files /dev/null and b/content/en/docs/Client_Applications/Windows/thunderbird/link.png differ diff --git a/content/en/docs/Client_Applications/Windows/thunderbird/nc-calendar.png b/content/en/docs/Client_Applications/Windows/thunderbird/nc-calendar.png new file mode 100644 index 0000000..fa41851 Binary files /dev/null and b/content/en/docs/Client_Applications/Windows/thunderbird/nc-calendar.png differ diff --git a/content/en/docs/Client_Applications/Windows/thunderbird/network.png b/content/en/docs/Client_Applications/Windows/thunderbird/network.png new file mode 100644 index 0000000..47c204f Binary files /dev/null and b/content/en/docs/Client_Applications/Windows/thunderbird/network.png differ diff --git a/content/en/docs/Client_Applications/Windows/thunderbird/password.png b/content/en/docs/Client_Applications/Windows/thunderbird/password.png new file mode 100644 index 0000000..5a1ca31 Binary files /dev/null and b/content/en/docs/Client_Applications/Windows/thunderbird/password.png differ diff --git a/content/en/docs/Client_Applications/Windows/thunderbird/privatelink.png b/content/en/docs/Client_Applications/Windows/thunderbird/privatelink.png new file mode 100644 index 0000000..d2687a3 Binary files /dev/null and b/content/en/docs/Client_Applications/Windows/thunderbird/privatelink.png differ diff --git a/content/en/docs/Client_Applications/Windows/thunderbird/subscribe.png b/content/en/docs/Client_Applications/Windows/thunderbird/subscribe.png new file mode 100644 index 0000000..9f0752f Binary files /dev/null and b/content/en/docs/Client_Applications/Windows/thunderbird/subscribe.png differ diff --git a/content/en/docs/Client_Applications/_index.md b/content/en/docs/Client_Applications/_index.md index 8426ef6..fffadfd 100755 --- a/content/en/docs/Client_Applications/_index.md +++ b/content/en/docs/Client_Applications/_index.md @@ -5,21 +5,12 @@ linkTitle: "Client Applications" weight: 6 date: 2017-01-05 description: > - What can your user do with your project? + There are many applications and operating systems that work with your Federated Core without having to use a web browser. --- {{% pageinfo %}} -This is a placeholder page that shows you how to use this template site. +This documentation is for users and administrators, not those wanting to install. {{% /pageinfo %}} -Think about your project’s features and use cases. Use these to choose your core tasks. Each granular use case (enable x, configure y) should have a corresponding tasks page or tasks page section. Users should be able to quickly refer to your core tasks when they need to find out how to do one specific thing, rather than having to look for the instructions in a bigger tutorial or example. Think of your tasks pages as a cookbook with different procedures your users can combine to create something more substantial. - -You can give each task a page, or you can group related tasks together in a page, such as tasks related to a particular feature. As well as grouping related tasks in single pages, you can also group task pages in nested folders with an index page as an overview, as seen in this example site. Or if you have a small docset like the [Docsy User Guide](https://docsy.dev/docs/) with no Tutorials or Concepts pages, consider adding your feature-specific pages at the top level of your docs rather than in a Tasks section. - -Each task should give the user - -* The prerequisites for this task, if any (this can be specified at the top of a multi-task page if they're the same for all the page's tasks. "All these tasks assume that you understand....and that you have already...."). -* What this task accomplishes. -* Instructions for the task. If it involves editing a file, running a command, or writing code, provide code-formatted example snippets to show the user what to do! If there are multiple steps, provide them as a numbered list. -* If appropriate, links to related concept, tutorial, or example pages. +You can use your Federated Core without using a web browser. We have collected a number of great applications and operating systems that work well with your Federated Core. We would love to have your ideas and pointers, too. diff --git a/public/blog/2023/05/30/helping-with-federated-core-documentation/index.html b/public/blog/2023/05/30/helping-with-federated-core-documentation/index.html index c44a150..7395057 100644 --- a/public/blog/2023/05/30/helping-with-federated-core-documentation/index.html +++ b/public/blog/2023/05/30/helping-with-federated-core-documentation/index.html @@ -113,10 +113,10 @@