summary refs log blame commit diff stats
path: root/readme
blob: a7ba65e7783217e97135ebad093191db7e670b29 (plain) (tree)








































                                               


                                          

                                      





                                                  
In this directory are programs for facilitating
practical and programatic updating of neocities
web pages. The various files written in C are
dedicated to the generation of HTML via the
neocities API's JSON output. The various shell
scripts are dedicated to downloading and
uploading via that API.

Each of 'composed.c', 'files.c',
'drawn/monthly.c', and photographed/monthly.c
may be interpreted by a C89 compiler, and
the output program may be used to generate
valid HTML. 'composed.c' is designed to
generate a web page featuring musical works,
requiring 'files.json' and files in 'lyrics'.
'files.c' is designed to generate a map of a
a neocities site, given the availability of
'files.json'. 'drawn/monthly.c' is designed
to generate a series of web pages featuring
images, with each web page separated by
month. 'photographed/monthly.c' is the same
program as 'drawn/monthly.c', with different
file paths programmed in.

'update.sh' is dedicated to the direct
interaction with the neocities API required
for downloading 'files.json' or uploading
content generated from 'files.json'.
'./update.sh up' writes an updated copy of
a given site's file to 'files.json'.
./update.sh files' calls 'files', derivative
of 'files.c', to generates 'files.html' from
'files.json'. './update.sh up files drawn
photographed composed' first updates
'files.json', then calls each of the
programs that may be generated from the
previously mentioned files ending in '.c'
to generate HTML derivative of the newly
updated 'files.json', then uploads the
newly generated HTML to neocities. Each of
these actions may be issued via separate
commands as desired. Of these, 'files.c'
is most generically useful, while the rest
serve relatively personal purposes.

In the 'various' directory are various
shell scripts and a C program, each of
which may facilitate generic uploads. For details,
see 'various/readme' and 'various/neoup/readme'.
These may be generically useful for maintaining
any neocities site, with only insertion of valid
authentification information required.