User Tools

Site Tools

Trace:
gemini_site_setup_and_hosting_features

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
gemini_site_setup_and_hosting_features [2021/05/10 20:06] – [Fleshing Out Your Gemini Capsule] 'fleshing' sounds gross to me, even though I wrote it initially peteyboygemini_site_setup_and_hosting_features [2024/10/28 21:48] (current) – updated links peteyboy
Line 3: Line 3:
 Welcome to the wonderful retro/alternative future of Gemini space! Welcome to the wonderful retro/alternative future of Gemini space!
  
-Here's the [[https://gemini.circumlunar.space/docs/faq.gmi|FAQ on Gemini]]. TL;DR, Gemini is an alternate internet protocol to either [[https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol| HTTP]] or [[https://en.wikipedia.org/wiki/Gopher| Gopher]]. It's being touted as a modern alternative to Gopher, to bring back a lightweight, text-centric interweb but with some of the security features of modern day. As described in the FAQ: +Here's the [[https://geminiprotocol.net/docs/faq.gmi|FAQ on Gemini]]. TL;DR, Gemini is an alternate internet protocol to either [[wp>wiki/Hypertext_Transfer_Protocol| HTTP]] or [[wp>Gopher_(protocol)|Gopher]]. It's being touted as a modern alternative to Gopher, to bring back a lightweight, text-centric interweb but with some of the security features of modern day. As described in the FAQ: 
->You may think of Gemini as "the web, stripped right back to its essence" or as "Gopher, souped up and modernised just a little"...+>You may think of Gemini as “the web, stripped right back to its essence” or as “Gopher, souped up and modernised just a little”...
  
-Creating your own //Gemini site ((SDF **Cluster** Gemini server: **//<nowiki>gemini://sdf.org</nowiki>//** ; SDF **Meta** Gemini server: **//<nowiki>gemini://gem.sdf.org</nowiki>//** .))// ("gemini capsule" the kids call them now) can be fun and SDF gives gemini space to all its users. There are currently two Gemini servers available on SDF, one on the cluster (for all users) and another on the [[metaarray]] for META users.+Creating your own //Gemini site ((SDF **Cluster** Gemini server: **//<nowiki>gemini://sdf.org</nowiki>//** ; SDF **Meta** Gemini server: **//<nowiki>gemini://gem.sdf.org</nowiki>//** .))// (“gemini capsule” the kids call them now) can be fun and SDF gives gemini space to all its users. There are currently two Gemini servers available on SDF, one on the cluster (for all users) and another on the [[metaarray]] for META users.
  
 You can begin creating your own websites straight away! You can begin creating your own websites straight away!
  
 In this tutorial when text looks like ''this'', this means it's a command you can run in your shell, either from the cluster, or if you've logged into the meta array. In this tutorial when text looks like ''this'', this means it's a command you can run in your shell, either from the cluster, or if you've logged into the meta array.
 +
 +===== Viewing Gemini Pages =====
 +
 +To start with, there are many ways to view your page and others in Geminispace. Here are the easiest ways you can [[accessing web spaces#Gemini| view gemini pages from the SDF shell]]
  
 ===== Getting Started ===== ===== Getting Started =====
Line 16: Line 20:
  
 SDF serves users' gemini content from two places: SDF serves users' gemini content from two places:
-  * **//<nowiki>gemini://sdf.org</nowiki>//** on the cluster +  * gemini://sdf.org on the cluster 
-  * **//<nowiki>gemini://gem.sdf.org</nowiki>//** on the Meta Array+  * gemini://gem.sdf.org on the Meta Array
  
 First, choose if you want to put your files on the cluster or the Meta Array. If you aren't on the Meta Array, then the cluster is your only choice. First, choose if you want to put your files on the cluster or the Meta Array. If you aren't on the Meta Array, then the cluster is your only choice.
Line 23: Line 27:
   * Log in to your account on the cluster or the MetaArray   * Log in to your account on the cluster or the MetaArray
     * for the cluster Gemini space, create your directory in ''/ftp/pub/users'' with at least an //index.gmi// file:     * for the cluster Gemini space, create your directory in ''/ftp/pub/users'' with at least an //index.gmi// file:
-      * use '''mkgopher'''((The SDF [[gopher site setup and hosting features#sdf_gopher_command|mkgopher]] tool manages workspace for both gemini & gopher)): +      * use ‘''mkgopher''’ ((The SDF [[gopher site setup and hosting features#sdf_gopher_command|mkgopher]] tool manages workspace for both gemini & gopher)): 
         * at command prompt, enter: ''mkgopher''         * at command prompt, enter: ''mkgopher''
         * in the mkgopher program, type ''setup''         * in the mkgopher program, type ''setup''
Line 39: Line 43:
   nano /meta/gemini/${LOGNAME}/index.gmi   nano /meta/gemini/${LOGNAME}/index.gmi
  
 +This command starts the nano text editor, creating a new file, called ‘index.gmi’ in your Gemini capsule directory.
  
-This command starts the nano text editor, creating a new file, called 'index.gmi' in your Gemini capsule directory. +Once you've executed the command above. You'll notice that the terminal layout has changed. If you press keys on your keyboard you'll notice they appear in the “text buffer”. Write out the text below into this program.
- +
-Once you've executed the command above. You'll notice that the terminal layout has changed. If you press keys on your keyboard you'll notice they appear in the "text buffer". Write out the text below into this program.+
  
   #My First Page!   #My First Page!
Line 51: Line 54:
   => gemini://gem.sdf.org To the SDF Meta Array Gemini Homepage   => gemini://gem.sdf.org To the SDF Meta Array Gemini Homepage
  
-Now that you have copied the text out into 'nano', you need to save the file. To do this, hold down the 'CTRL' key on your keyboard and whilst pressing that, press the letter 'x', and respond "yes" to the request to save. You've just written your first //gemtext// file. It's a very simple markup language compared to HTML, as you can see.+Now that you have copied the text out into ‘nano’, you need to save the file. To do this, hold down the ‘CTRL’ key on your keyboard and whilst pressing that, press the letter ‘x’, and respond “yes” to the request to save. You've just written your first //gemtext// file. It's a very simple markup language compared to HTML, as you can see. 
 + 
 +**NOTE: file permissions:** to be able to see this file with a browser, you need to change the permissions. at the command line after saving your file, just enter ''chmod go+r index.gmi''. This will grant read permissions on that particular file to everyone else besides you.
  
 Now, just open a Gemini browser and navigate to either: Now, just open a Gemini browser and navigate to either:
   * for your Gemini page on the cluster: ''<nowiki>gemini://sdf.org/{yourusername}/</nowiki>''   * for your Gemini page on the cluster: ''<nowiki>gemini://sdf.org/{yourusername}/</nowiki>''
   * for your Gemini page on the Meta Array: ''<nowiki>gemini://gem.sdf.org/{yourusername}</nowiki>''   * for your Gemini page on the Meta Array: ''<nowiki>gemini://gem.sdf.org/{yourusername}</nowiki>''
- 
  
 You should see your very own Gemini capsule! You should see your very own Gemini capsule!
Line 62: Line 66:
 Once you've created your directory and ''index.gmi'' file you will be added to Once you've created your directory and ''index.gmi'' file you will be added to
 the top index.  Sites are listed by most recent activity first and will the top index.  Sites are listed by most recent activity first and will
-include a title if you have one in your ''index.gmi'' +include a title if you created a heading (e.g.,‘##My First Page!’) on the first line of your ''index.gmi''
- +
- +
-==== Viewing Your Gemini Homepage ==== +
- +
-You can use either of these Gemini browsers on the cluster or in the MetaArray: +
-  * //bombadillo//:  at shell type ''bombadillo <nowiki>gemini://sdf.org/{yourusername}/</nowiki>'' (this would go to your cluster page) or  +
-  * //av98//:  at shell type ''av98 <nowiki>gemini://gem.sdf.org/{yourusername}/</nowiki>'' (this would go to your [[metaarray]] page) +
- +
-Additionally, on the metaarray, you can use ''diohsc'' +
- +
-If you want to get into Gemini more, there are shell and graphical clients available for Linux, Windows, Mac, Android and IOS, you can look for them here: //<nowiki>gemini://gemini.circumlunar.space/software/</nowiki>// +
- +
- +
  
 ===== Building Out Your Gemini Capsule ===== ===== Building Out Your Gemini Capsule =====
  
-You can get more direction on the native markup for Gemini, called //gemtext// by reading the gemtext specification, which can be found by navigating to //[[gemini://gemini.circumlunar.space/docs/gemtext.gmi]]//+You can get more direction on the native markup for Gemini, called //gemtext// by reading the [[https://geminiprotocol.net/docs/gemtext.gmi|gemtext specification]] (or, of course, to the same page via gemini, gemini://geminiprotocol.net/docs/gemtext.gmi
  
gemini_site_setup_and_hosting_features.1620677176.txt.gz · Last modified: 2021/05/10 20:06 by peteyboy