Differences

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

--- gemini_site_setup_and_hosting_features [2021/03/17 18:11] – italicized the gemini link since dokuwiki doesn't know it's really a link peteyboy
+++ gemini_site_setup_and_hosting_features [2023/06/30 23:39] – [Building Out Your Gemini Capsule] hc9
@@ Line 1: / Line 1: @@
-====== Introduction ======
-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:
->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 ("gemini capsule" the kids call them now) can be fun and SDF gives gemini space to all its [[the_metaarray| MetaARPA]] users, so the moment you become META (see https://sdf.org/?join) 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, once you've logged into the meta array SDF.
-===== Getting Started =====
-Gemini hosting is super easy on SDF.
-  * Log in to the MetaArray
-  * create your directory in /meta/gemini with at least a index.gmi file: ''mkdir -p /meta/gemini/${LOGNAME}''
-Now on to make your first gemini page!
-===== Your First Page! =====
-Creating your first page is SO easy! First you'll need to open a text editor. SDF has many text editors installed but new users to UNIX often find that nano is the easiest to work with.
-  nano /meta/gemini/${LOGNAME}/index.gmi
-This command starts the nano text editor, creating a new file, called 'index.gmi' in your ///meta/gemini/{username}// 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.
-  #My First Page!
-  This is my first page in Gemini space!
-  => gemini://gem.sdf.org  Back to the SDF 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, just open a Gemini browser and navigate to ''<nowiki>gemini://gem.sdf.org/{yourusername}</nowiki>''. You should see your very own Gemini capsule!
-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
-include a title if you have one in 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://gem.sdf.org/{yourusername}</nowiki>''
-  * //av98//:  at shell type ''av98 <nowiki>gemini://gem.sdf.org/{yourusername}</nowiki>''
-Additionally, on the metaarray, you can use ''diohsc''
-===== Fleshing 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]]//