| Both sides previous revision
Previous revision
Next revision
|
Previous revision
|
building_a_website_on_sdf [2022/08/02 20:08]
peteyboy added table with web server software, fixed the outline levels |
building_a_website_on_sdf [2022/08/10 23:34]
peteyboy regularize paths as italic, and monospace for commands |
| Creating your own websites can be fun and SDF gives webspace to all its validated users, so the moment you become validated you can begin creating your own websites straight away. | Creating your own websites can be fun and SDF gives webspace to all its validated users, so the moment you become validated 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 SDF. | 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 SDF. |
| |
| ==== Getting Started ==== | ==== Getting Started ==== |
| |
| ''mkhomepg'' - This command needs to be executed before you can start building your web pages. When you execute this program, it will create a directory in which you can put all your web files. This directory is sym-linked into your home directory, under the name //html//. (A sym-link is sort of like a shortcut in Microsoft Windows.)You will be prompted to select a URL for your website. This URL is what other internet users type into their web browser to view your web pages. If you're not an ARPA member then you may only use url's in the form of //<your login>.freeshell.org//. For instance, user //((the original author of this tutorial: thanks, alterego!))alterego//'s web pages are stored at //alterego.freeshell.org//. If you're an ARPA member, there are many different domains you may use. | ''mkhomepg'' - This command needs to be executed before you can start building your web pages. When you execute this program, it will create a directory in which you can put all your web files. This directory is sym-linked into your home directory, under the name //html//. (A sym-link is sort of like a shortcut in Microsoft Windows.)You will be prompted to select a URL for your website. This URL is what other internet users type into their web browser to view your web pages. If you're not an ARPA member then you may only use urls in the form of //<your login>.freeshell.org//. For instance, user //((the original author of this tutorial: thanks, alterego!))alterego//'s web pages are stored at //alterego.freeshell.org//. If you're an ARPA member, there are many different domains you may use. |
| |
| So first, run at your ($) prompt: | So first, run at your ($) prompt: |
| 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. | 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 ~/html/index.html'' - This command starts the nano text editor, creating a new file, called 'index.html' in your html 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. | ''nano ~/html/index.html'' - This command starts the nano text editor, creating a new file, called //index.html// in your html 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. |
| |
| <html> | <html> |
| </html> | </html> |
| |
| 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 answer ''Y'' to the prompt to save, after which nano will exit. | 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 answer ''Y'' to the prompt to save, after which nano will exit. |
| |
| Right, now, do you remember that URL you selected when you ran '"mkhomepg"'? Open a web browser and type that into the address bar. Hopefully, after a few seconds. You should see your very own web page! | Right, now, do you remember that URL you selected when you ran ''mkhomepg''? Open a web browser and type that into the address bar. Hopefully, after a few seconds. You should see your very own web page! |
| |
| |
| mkhomepg -p | mkhomepg -p |
| </code> | </code> |
| The ''-p'' flag sets appropriate permissions for your ''~/html, ~/public_html'' directories on the cluster, including your VHOSTS, as well as your ''~/html/<username>'' directory on the [[metaarray|The MetaArray]]. | The ''-p'' flag sets appropriate permissions for your //~/html//, //~/public_html/// directories on the cluster, including your VHOSTS, as well as your //~/html/<username>// directory on the [[metaarray|The MetaArray]]. |
| |
| |
| * **Standard Site:** By default, your web site files go in your user folder on the cluster in the ''html'' subfolder. These files are then viewable at //<your login>.freeshell.org//, or what other domain you set as a custom url with mkhomepg or from the ''maint'' command | * **Standard Site:** By default, your web site files go in your user folder on the cluster in the ''html'' subfolder. These files are then viewable at //<your login>.freeshell.org//, or what other domain you set as a custom url with mkhomepg or from the ''maint'' command |
| * **'Tilde' Site:** You may, if you first run ''mkhomepg -d'' also (or instead) place files in your ''public_html'' folder, and they will be accessible at your old school "tilde site" at //sdf.org/~<your login>// | * **'Tilde' Site:** You may, if you first run ''mkhomepg -d'' also (or instead) place files in your ''public_html'' folder, and they will be accessible at your old school "tilde site" at //sdf.org/~<your login>// |
| * **Virtual Host:** If you have a [[vhost]], you should place files for it in your ''<nowiki>/html/vhost_name</nowiki>'' folder, and they will appear from your properly configured VHOST, if you have signed up for this [[membership_levels|membership]] | * **Virtual Host:** If you have a [[vhost]], you should place files for it in your //<nowiki>/html/vhost_name</nowiki>// folder, and they will appear from your properly configured VHOST, if you have signed up for this [[membership_levels|membership]] |
| * **[[metaarray|The MetaArray]]:** If you want to host from the unlimited storage of the MetaArray, after you use ''mkhomepg -t'' to toggle your main web page from the cluster to the MetaArray, you should put your files on the metaarray at ''~/html/<username>'', and as with the cluster, these will be accessible at //<your login>.freeshell.org//, or what other domain you set as a custom url with mkhomepg or from the ''maint'' command | * **[[metaarray|The MetaArray]]:** If you want to host from the unlimited storage of the MetaArray, after you use ''mkhomepg -t'' to toggle your main web page from the cluster to the MetaArray, you should put your files on the metaarray at //~/html/<username>//, and as with the cluster, these will be accessible at //<your login>.freeshell.org//, or what other domain you set as a custom url with mkhomepg or from the ''maint'' command |
| |
| ===== Problems ===== | ===== Problems ===== |
