folk.zone Wiki

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

====== Publishing on a Pubnix ======

How tildes serve user content. The model is the same across town, pink, club, green, envs, and sdf.

===== The Directories =====

Anything dropped in is live immediately. No deploy step, no build queue: the server is just a web server reading your home directory.

===== Permissions =====

The thing everyone forgets:

<code bash>
chmod 755 ~                           # home must be traversable
chmod 755 ~/public_html               # dirs: 755
chmod 644 ~/public_html/index.html    # files: 644
chmod 664 file                        # communal file: group-write
chmod 775 dir                         # communal dir
</code>

The symptom of getting this wrong is a ''403 Forbidden'' on a file that definitely exists. It is always permissions.

===== The Workflow =====

Edit locally, push with rsync:

<code bash>
rsync -avhP --delete ~/site/ host:public_html/
rsync -avhP ~/site/ you@tilde.town:public_html/
</code>

* ''--delete'' mirrors exactly. Preview with ''-n'' (dry run) first.
  * ''sshfs'' works too (''sshfs host:public_html ~/mnt''), but rsync does not depend on connection quality.
  * On the host, everything is editable live: ssh in, edit ''~/public_html/index.html'' in nano or vim, done.

===== Town-Specific Conventions =====

* **ttbp** ("feels"): the town diary tool. One plaintext entry per day, renders to ''~/public_html/feels/'' and gopher. See [[tilde:tools|tilde.town Tools]].
  * **town planet**: the blog aggregator. List your feed URL in ''~/.planetfeeds'' to join it. See [[indieweb:rss_by_hand|RSS by Hand]] for making a feed.
  * **town square**: ''/town/square/public_html'' maps to ''tilde.town/square''. Shared and world-writable. See [[tilde:town_square|Town Square]].
  * **guestbook.txt**: convention for leaving notes. Link it from your index so visitors know it exists.

===== What Feels Native =====

* Hand-written or lightly generated HTML. Heavy JS sites feel alien on a pubnix.
  * Link to your other tildes. Webring and badge culture is alive: 88x31 buttons are the convention.
  * ''robots.txt'' and a favicon are cheap politeness.
  * A ''.plan'' file (what ''finger you@host'' shows) is the old-school status line. See [[terminal:shell:plan|.plan and .project]].

===== See Also =====

Edit summary

Note: By editing this page you agree to license your content under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International