Jump to content

Tjenester/Hjemmesider: Difference between revisions

From Programvareverkstedet
Simplify instructions
Add instructions for adding your first files.
Line 13: Line 13:
** <b><code><nowiki>ls -ld ~ ~/web-docs</nowiki></code></b> skal så vise minst: <code><nowiki>drwx--x--x</nowiki></code> og <code><nowiki>drwxr-xr-x</nowiki></code> (det kan være at det står <code><nowiki>drwxr-sr-x</nowiki></code> på den siste
** <b><code><nowiki>ls -ld ~ ~/web-docs</nowiki></code></b> skal så vise minst: <code><nowiki>drwx--x--x</nowiki></code> og <code><nowiki>drwxr-xr-x</nowiki></code> (det kan være at det står <code><nowiki>drwxr-sr-x</nowiki></code> på den siste
* Legg en <code>index.html</code> eller lignende i <code>web-docs</code>.
* Legg en <code>index.html</code> eller lignende i <code>web-docs</code>.
== Flytte filer til hjemmesiden ==
Du kan kopiere filer til <code>web-docs</code> med <code>scp</code> fra din egen maskin:
<pre>
# Kopier filene index.html og bilde.png til ~/web-docs/...
scp index.html bilde.png brukernavn@login.pvv.ntnu.no:web-docs/
# Kopier katalogen prosjekt til ~/web-docs/prosjekt
scp -r prosjekt brukernavn@login.pvv.ntnu.no:web-docs/
</pre>
Filene får de samme rettighetene som på din maskin. Dersom du får <code>403 Forbidden</code> etterpå, logg inn på en [[Tjenester/Login-bokser|loginboks]] og kjør <code>chmod -R a+rX ~/web-docs</code>.
Har du siden i git, kan du også klone repoet rett inn i <code>web-docs</code> og oppdatere med <code>git pull</code>. <code>.git</code>-katalogen blir ikke servert.


== Logger ==
== Logger ==
Line 77: Line 93:
* Put an <code>index.html</code> or similar in <code>web-docs</code>.
* Put an <code>index.html</code> or similar in <code>web-docs</code>.


== Copying files to your homepage ==
You may copy files to <code>web-docs</code> using <code>scp</code> from your own computer:
<pre>
# Copy the files index.html and picture.png to ~/web-docs/...
scp index.html picture.png username@login.pvv.ntnu.no:web-docs/
# Copy the directory project to ~/web-docs/project
scp -r project username@login.pvv.ntnu.no:web-docs/
</pre>
The files keep the permissions they have on your computer. If you get <code>403 Forbidden</code> afterwards, log onto a [[Tjenester/Login-bokser|login box]] and run <code>chmod -R a+rX ~/web-docs</code>.
If your keep your site as a git project, you can clone the repository straight into <code>web-docs</code> and update it with <code>git pull</code>. The <code>.git</code> directory will not served.


== Logger ==
== Logger ==

Revision as of 16:51, 19 November 2026

English

En hjemmeside er ett eller flere dokument som befinner seg på en brukers hjemmekatalog.

For å lage din egen hjemmeside her på PVV må du gjøre følgende:

  • Les Webreglement
  • Logg inn på en av loginboksene med SSH.
  • Lag katalogen web-docs i rotnivået av hjemmekatalogen din. Kjør kommandoen: mkdir ~/web-docs. Merk at denne katalogen IKKE heter public_html, slik den gjør på studentsalene.
  • Gi vevtjeneren tilgang:
    • Hjemmekatalogen din ha execute-tilgang for gruppa og andre: chmod g+x,o+x ~
    • web-docs må i tillegg være leselig: chmod g+rx,o+rx ~/web-docs
    • ls -ld ~ ~/web-docs skal så vise minst: drwx--x--x og drwxr-xr-x (det kan være at det står drwxr-sr-x på den siste
  • Legg en index.html eller lignende i web-docs.

Flytte filer til hjemmesiden

Du kan kopiere filer til web-docs med scp fra din egen maskin:

# Kopier filene index.html og bilde.png til ~/web-docs/...
scp index.html bilde.png brukernavn@login.pvv.ntnu.no:web-docs/

# Kopier katalogen prosjekt til ~/web-docs/prosjekt
scp -r prosjekt brukernavn@login.pvv.ntnu.no:web-docs/

Filene får de samme rettighetene som på din maskin. Dersom du får 403 Forbidden etterpå, logg inn på en loginboks og kjør chmod -R a+rX ~/web-docs.

Har du siden i git, kan du også klone repoet rett inn i web-docs og oppdatere med git pull. .git-katalogen blir ikke servert.

Logger

Dersom du ønsker å motta logger for besøk på hjemmesiden din (for eksempel for å lage statistikk) kan du opprette katalogen ~/nobackup/weblogs. Loggen vil da bli skrevet dit fortløpende, i separate filer for hver dag.

CGI-script

CGI-script er programmer som skriver ut headere og HTML. De er ofte skrevet i Perl, Python eller et tilsvarende språk. For å bruke et cgi-script på PVV holder det å gi det endelsen ".cgi". PHP på PVV kjøres ikke som CGI men som en egen Apache-modul, og du kan derfor bruke PHP direkte uten noe om og men.

Om du av en eller annen grunn ikke vil kalle CGI-scriptene dine noe som ender på .cgi (for eksempel fordi du bruker noe tredjeparts programvare du ikke vil tukle for mye med) kan du lage en egen cgi-katalog på denne måten:

  1. Opprette en dedikert CGI-katalog (f.eks cgi-bin) i web-docs katalogen din.
  2. Legg inn filen .htaccess med innholdet:
Options +ExecCGI -Indexes
SetHandler cgi-script
  1. Gjøre katalogen og .htaccess tilgjengelig for andre. (Bruk chmod a+rx katalog og chmod a+r .htaccess.)
  2. Alle filer du legger i denne katalogen, og i underkataloger, vil bli behandlet som CGI script og kjørt istedenfor å bli vist direkte. En typisk URL til et slikt script blir da http://www.pvv.ntnu.no/~bruker/cgi-bin/script

Visning av PHP-feilmeldinger

I utgangspunktet er ikke php-feilmeldinger vist. For at feilmeldinger skal vises, lag filen .htaccess med følgende innhold:

php_flag display_errors on
php_value error_reporting E_ALL

Filen lages i katalogen til scriptet som skal kjøres.

Opplastingsgrense for PHP

Maks størrelse på filopplasting i PHP er satt til 40 MB (post_max_size og upload_max_filesize).

Tilgjengelig programvare

CGI- og PHP-script kjører i et sandboksmiljø med et fast sett med programmer og biblioteker. Du kan finne den fullstendige lista med programvare ved https://temmie.pvv.ntnu.no/environment/.

Eget domene o.l.

Det er ikke mulig å ha virtuell server for ditt eget domene på PVV. Du kan ha ikke-kommersielt innhold på PVV, men da må du få ISPen/webhotellet ditt til å sette opp en http-videresending (redirect) til http://www.pvv.ntnu.no/~bruker/

Det er ikke tilstrekkelig å lage en DNS-peker til PVVs web-server, da dette forutsetter at PVV setter opp en virtuell server eller en redirect til dine sider på serveren.

Grunnene for hvorfor det er sånn er flere, men primært er det fordi PVV som helhet er underlagt NTNUs IT-reglement.

Se også

Teknisk informasjon om webserver

Homepages

A homepage is one or more documents located in a users home directory.

To make your own homepage at PVV, you should do the following:

  • Read the web rules
  • Log onto one of the login boxes with SSH.
  • Make a directory web-docs in your home directory. Run the command: mkdir ~/web-docs. Note that the directory is NOT named public_html, as it is on NTNU's student computer labs.
  • Give the webserver access:
  • Set the correct attributes on your home directory and the web-docs catalog.
    • Your home directory should have execute-permissions for its group and others: chmod g+x,o+x ~
    • web-docs must also be readable: chmod g+rx,o+rx ~/web-docs
    • ls -ld ~ ~/web-docs should then show at least drwx--x--x and drwxr-xr-x (the last one might say drwxr-sr-x instead)
  • Put an index.html or similar in web-docs.

Copying files to your homepage

You may copy files to web-docs using scp from your own computer:

# Copy the files index.html and picture.png to ~/web-docs/...
scp index.html picture.png username@login.pvv.ntnu.no:web-docs/

# Copy the directory project to ~/web-docs/project
scp -r project username@login.pvv.ntnu.no:web-docs/

The files keep the permissions they have on your computer. If you get 403 Forbidden afterwards, log onto a login box and run chmod -R a+rX ~/web-docs.

If your keep your site as a git project, you can clone the repository straight into web-docs and update it with git pull. The .git directory will not served.

Logger

If you wish to receive logs on visits to your home page (for an instance to make statistics) you can make the directory ~/nobackup/weblogs. The log with then be written continuously, in separate files each day.

CGI-script

CGI-script are programs that write headers and HTML. They are often written in Perl, Python or a similar language. To use a cgi-script at PVV it is sufficient to give it the file extension .cgi. PHP at PVV is not run as cgi but as a separate Apache module, and you can therefore use PHP directly without having to do any additional work.

If you for some reason don't want to name your CGI-scripts something that ends on ".cgi" (for an instance because you use some third party software that you do not want to fiddle too much with) you can make a cgi catalog in this way:

  1. Make a dedicated CGI-catalog (for an instance cgi-bin) in your web-docs catalog.
  2. Add the file .htaccess with the content:
Options +ExecCGI -Indexes
SetHandler cgi-script
  1. Make the catalog and .htaccess available for others. (Use chmod a+rx catalog and chmod a+r .htaccess.)
  2. All files that yoy put in this catalog, and in sub-catalogs, will be treated as CGI-script and run instead of getting show directly. A typical URL to such a script then becomes: http://www.pvv.ntnu.no/~bruker/cgi-bin/script

Displaying PHP error messages

By default php error messages are not shown. For error messages to be shown, make the file .htaccess with the following content:

php_flag display_errors on
php_value error_reporting E_ALL

The file must be made in the directory of the script that is to be run.

Upload limit

The maximum size for PHP file uploads is 40 MB (post_max_size and upload_max_filesize).

Available software

CGI and PHP scripts run in a sandbox with a fixed set of programs and libraries. You may find the full list of software at https://temmie.pvv.ntnu.no/environment/

Your own domain and similar things

It is not possible to have a virtual server for your own domain at PVV. You can have non-commercial content on PVV, but you must then make your ISP/web-hotel set up a HTTP-forwarding (redirect) to http://www.pvv.ntnu.no/~user/

It is not sufficient to make a DNS-pointer to PVVs web-server, because this requires that PVV sets up a virtual server or a redirect to your pages on the server.

There are several reasons for this, but it is primarily because PVV as a whole is subject to NTNUs IT-rules.

Also See

Technical information about webserver