{"id":25019651,"url":"https://github.com/djeada/personal-website","last_synced_at":"2025-04-28T14:04:13.870Z","repository":{"id":114372154,"uuid":"230303344","full_name":"djeada/Personal-Website","owner":"djeada","description":"Welcome to the GitHub repository for adamdjellouli.com. Your feedback, comments, and suggestions for improvements are highly appreciated. Your support is invaluable to me.","archived":false,"fork":false,"pushed_at":"2025-04-23T21:27:36.000Z","size":42118,"stargazers_count":1,"open_issues_count":5,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-23T21:34:09.814Z","etag":null,"topics":["blog","css","css3","html","html5","javascript","personal-website","typescript"],"latest_commit_sha":null,"homepage":"https://adamdjellouli.com","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/djeada.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-12-26T17:36:02.000Z","updated_at":"2025-04-23T21:27:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"e17a9660-c044-45ff-bdfc-1402fe5d94e3","html_url":"https://github.com/djeada/Personal-Website","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djeada%2FPersonal-Website","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djeada%2FPersonal-Website/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djeada%2FPersonal-Website/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djeada%2FPersonal-Website/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/djeada","download_url":"https://codeload.github.com/djeada/Personal-Website/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251326807,"owners_count":21571632,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blog","css","css3","html","html5","javascript","personal-website","typescript"],"created_at":"2025-02-05T11:51:21.019Z","updated_at":"2025-04-28T14:04:13.462Z","avatar_url":"https://github.com/djeada.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Personal Website\n\nWelcome to the GitHub repository for [adamdjellouli.com](https://adamdjellouli.com)! Your feedback, comments, and suggestions for improvements are highly appreciated. Your support is invaluable to me.\n\n## 📖 Overview\n\nThis repository hosts the code for my personal website. It's a space where I share my thoughts, projects, and various topics that spark my interest. The site is meticulously crafted using HTML, CSS, and TypeScript, augmented with custom Python scripts for updating common elements across pages.\n\n## 🌐 Live Demo\n\nCheck out the live website: [adamdjellouli.com](https://adamdjellouli.com)\n\n## 🖼️ Screenshot\n\n![A glimpse of adamdjellouli.com](https://user-images.githubusercontent.com/37275728/185813314-328d17a4-df7c-4156-8bf0-0fb211d055eb.PNG)\n\n## 📑 Table of Contents\n\n- [Philosophy](#💡-philosophy)\n- [Building Blocks](#🛠️-building-blocks)\n- [Technologies](#🔧-technologies)\n- [Getting Started](#🚀-getting-started)\n- [Scripts](#📜-scripts)\n- [Contributing](#🤝-contributing)\n- [License](#📄-license)\n\n## 💡 Philosophy\n\n- **Dedication to Originality**: No use of boilerplates, templates, or frameworks.\n- **From Scratch**: Building everything from the ground up with HTML, CSS, and TypeScript.\n- **Automation**: Regular updates to all common page elements through custom Python scripts for consistency and efficiency.\n\n## 🛠️ Building Blocks\n\nThe website consists of these fundamental components:\n\n### **HTML Elements**\n\n- Header\n- Navigation Bar\n- Footer\n- Main Content Section\n- Individual Article Pages\n\n### **CSS Files**\n\n- General Components\n- Navigation Bar Styling\n- Footer Styling\n\n## 🔧 Technologies\n\nThis project employs the following technologies:\n\n- [HTML5](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/HTML5)\n- [CSS3](https://developer.mozilla.org/en-US/docs/Web/CSS)\n- [TypeScript](https://www.typescriptlang.org/)\n- [Python](https://www.python.org/) (for build scripts)\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n- **Node.js** and **npm** installed.\n- **Python 3** installed.\n\n### Installation\n\n1. **Clone the repository**\n\n```bash\ngit clone https://github.com/yourusername/yourrepository.git\ncd yourrepository\n```\n\n2. **Run Build Scripts**\n\n```bash\npython run_all.py\n```\n\n## 📜 Scripts\n\nThis directory contains a set of Python scripts designed to build and maintain the personal website. Each script serves a specific purpose in the process of converting content, styling, and organizing the website's structure.\n\n### Script Descriptions\n\n- **`apply_common_elements.py`**: Integrates common elements (like headers and footers) across all HTML files in the website, ensuring consistency in design and navigation.\n\n- **`bundle_css.py`**: Consolidates multiple CSS files from the `resources/assets` directory into a single `style.css` file. This improves page load times by reducing the number of HTTP requests.\n\n- **`clean_output_dirs.py`**: Cleans and prepares output directories, ensuring a fresh environment for each build process.\n\n- **`create_site_map.py`**: Generates a sitemap of the website, which is crucial for SEO and helps search engines index the site more effectively.\n\n- **`format.sh`**: A shell script to format and lint code, maintaining code quality and consistency throughout the project.\n\n- **`generate_article_list.py`**: Compiles a list of all articles or blog posts rendered on a specific section of the website (blog).\n\n- **`generate_from_markdown.py`**: Converts Markdown files, primarily used for the blog section, into HTML format for web presentation.\n\n- **`generate_related_articles_section.py`**: Creates a section on each article page that suggests related articles, enhancing user engagement.\n\n- **`generate_table_of_contents.py`**: Produces a table of contents for articles, making longer content more navigable.\n\n- **`get_markdown_urls.py`**: Extracts and lists URLs from Markdown files, which are sources from which the articles will be generated.\n\n- **`run_all.py`**: A comprehensive script that executes all the above scripts in the required sequence. It acts as a one-click solution to rebuild or update the entire website.\n\n### Usage\n\nTo run the entire website building process, execute:\n\n```bash\npython run_all.py\n```\n\nAlternatively, individual scripts can be run separately for specific tasks as needed.\n\n## 🤝 Contributing\n\nWe encourage contributions that enhance the repository's value. To contribute:\n\n1. **Fork the repository**\n\n2. **Create your feature branch**\n\n```bash\ngit checkout -b feature/AmazingFeature\n```\n\n3. **Commit your changes**\n\n```bash\ngit commit -m 'Add some AmazingFeature'\n```\n\n4. **Push to the branch**\n\n```bash\ngit push origin feature/AmazingFeature\n```\n\n5. **Open a Pull Request**\n\n## 📄 License\n\nThis project is licensed under the [MIT License](LICENSE) - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjeada%2Fpersonal-website","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdjeada%2Fpersonal-website","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjeada%2Fpersonal-website/lists"}