Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision |
gemini_site_setup_and_hosting_features [2021/04/10 21:11] – fix typo in pub url peteyboy | gemini_site_setup_and_hosting_features [2022/12/05 06:15] – hc9 |
---|
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://gemini.circumlunar.space/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"... |
| |
* 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: |
* ''mkdir -p /ftp/pub/users/${LOGNAME}'' | * 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'' |
| * in the mkgopher program, type ''setup'' |
| * type ''quit'' to exit. Your gemini (& gopher) directory should be set up with proper permissions at ''/ftp/pub/users/${LOGNAME}'' |
* for the Meta Array Gemini space, create your directory in ''/meta/gemini'' with at least a //index.gmi// file: | * for the Meta Array Gemini space, create your directory in ''/meta/gemini'' with at least a //index.gmi// file: |
* ''mkdir -p /meta/gemini/${LOGNAME}'' | * ''mkdir -p /meta/gemini/${LOGNAME}'' |
| |
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: |
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'' |
| |
| |
You can use either of these Gemini browsers on the cluster or in the MetaArray: | 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 | * //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) | * //amfora//: at shell type ''amfora <nowiki>gemini://gem.sdf.org/{yourusername}/</nowiki>'' (this would go to your [[metaarray]] page) |
| |
Additionally, on the metaarray, you can use ''diohsc'' | Additionally, on the metaarray, you can use ''diohsc'' (located at ///meta/sdf/bin/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>// | 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 ===== |
| |
===== 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]]// | 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]]// |
| |