The source code for my personal website
Find a file
2024-05-06 21:17:48 +02:00
assets/common added logging out 2024-05-05 21:51:21 +02:00
docs added metadata 2024-05-06 21:17:48 +02:00
.gitignore update gitignore 2024-04-27 21:09:20 +02:00
deploy-local hopefully final deployment fixes 2023-12-21 17:20:36 +01:00
deploy-server hopefully final deployment fixes 2023-12-21 17:20:36 +01:00
README.md dynamic blogs and delayed header display 2024-04-28 15:21:09 +02:00
UNLICENSE added github link and license info 2023-12-21 18:07:05 +01:00

My personal home page

The goal of this website is to serve as my personal dumping grounds for some small web projects, a blog, maybe a booru gallery. Idk yet.

Deploy guide

If you want to use my website as some sort of a template for your own, feel free to do so! I would appreciate if you give me some form of a credit in the footer of your page, especially if you are going to just re-skin my page for your own blog site, but I do not require it. Anyways, let's get to the how.

  • My page is written in PHP, I run it on an apache server, but it probably should run on nginx as well, I am not sure though, as I have never tested it.
  • I am not going to walk you through LAMP setup, as that can be found elsewhere.
  • In the root of the project you will find a database.sql file, you should be able to use it to deploy my database schema. I use mariadb, but if you use mysql it should work as well.
  • The database is documented through comments viewable in phpmyadmin, if you have trouble displaying them in your database manager, let me know and I might get to writing some basic setup instructions here.
  • In the file docs/common/config.php you can set the connections to your database that will then be used in docs/common/header.php to connect to it and set the global variable $conn to the PDO connection object, you can use that in your own functions, if you add any.
  • If you have problems connecting to the database, you can try printing the PDO exception being caught there in the function attempt_sql_connect(), but be careful not to leave it in production, as it reveals some information you might want to keep from users.
  • The basic skeleton for any document should be:
<?php
// This makes for less typing while including the header and the footer.
// Absolute path to the commons folder.
$COMMONS = $_SERVER['DOCUMENT_ROOT'] . "/../common";

// Include the common site-wide header.
include_once($COMMONS."/header.php");

// Display the header with desired title. This is a separate function for the
// cases where you want to set the title dynamically after doing some
// processing (which requires sql connection from the header for example).
// An example of this are the blogs, which first get their name from the
// databese, and only then display the header with the title being the name
// of the article.
display_header(<PAGETITLE>);
?>

<!--
Your main content here, try to wrap it in <article> tags for nice padding
-->

<?php
// Write out the footer and close the website.
include_once($COMMONS."/footer.php");
?>
  • Do check out the already existing css rules before adding your own, the rule for what you are trying to create might already exist. I might add a more comprehensive guide/documentation for the styles once I find myself getting lost in them, but I don't find it necessary yet so I will not bother. If you do, feel free to send me a pull request.
  • Hmm, what else may I be missing? Not sure now, if you miss something lmk. So I guess have fun!