{"id":32460491,"url":"https://github.com/pakjiddat/developers-site","last_synced_at":"2026-02-22T16:34:45.784Z","repository":{"id":259518415,"uuid":"176250869","full_name":"pakjiddat/Developers-Site","owner":"pakjiddat","description":"A simple website for developers","archived":false,"fork":false,"pushed_at":"2020-04-22T11:54:11.000Z","size":8367,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-26T11:59:20.405Z","etag":null,"topics":["simple-blog","simple-website"],"latest_commit_sha":null,"homepage":"https://pakjiddat.netlify.app/posts/developers-site","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pakjiddat.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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-03-18T09:49:28.000Z","updated_at":"2024-09-15T09:34:07.000Z","dependencies_parsed_at":"2024-10-26T06:24:56.161Z","dependency_job_id":"fe7db3ef-0e99-4cc4-99c0-fdcbe2b1ae2a","html_url":"https://github.com/pakjiddat/Developers-Site","commit_stats":null,"previous_names":["pakjiddat/developers-site"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/pakjiddat/Developers-Site","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pakjiddat%2FDevelopers-Site","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pakjiddat%2FDevelopers-Site/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pakjiddat%2FDevelopers-Site/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pakjiddat%2FDevelopers-Site/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pakjiddat","download_url":"https://codeload.github.com/pakjiddat/Developers-Site/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pakjiddat%2FDevelopers-Site/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29718450,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-22T15:10:41.462Z","status":"ssl_error","status_checked_at":"2026-02-22T15:10:04.636Z","response_time":110,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["simple-blog","simple-website"],"created_at":"2025-10-26T11:59:07.067Z","updated_at":"2026-02-22T16:34:45.772Z","avatar_url":"https://github.com/pakjiddat.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp\u003e\u003cimg src=\"https://pakjiddat.netlify.app/static/c079a165e6b60b8d38bff043b331a962/8c557/pakjiddat-website.png\" alt=\"Pak Jiddat Website\"/\u003e\u003c/p\u003e\n\n\u003ch3\u003eIntroduction\u003c/h3\u003e\n\u003cp\u003eThe \u003cb\u003e\"Developers Site\"\u003c/b\u003e project is a simple website that displays articles. It is suitable for developers who need a platform for publishing their work. A working example of the website is the: \u003ca href='https://www.pakjiddat.pk/'\u003ePak Jiddat website\u003c/a\u003e\u003c/p\u003e\n\n\u003ch3\u003eDevelopment of the website\u003c/h3\u003e\n\u003cp\u003eThe website was developed by following the \u003ca href='http://theleanstartup.com/principles'\u003eLean Startup principles\u003c/a\u003e. The book \u003ca href='https://www.packtpub.com/business/understanding-software'\u003eUnderstanding Software\u003c/a\u003e was an invaluable guide in the development of the website.\u003c/p\u003e\n\n\u003ch3\u003eFeatures\u003c/h3\u003e\n\u003cdiv\u003e\n\u003cul\u003e\n\u003cli\u003eThe website allows publishing articles\u003c/li\u003e\n\u003cli\u003eTable of contents are auto generated for articles with headings\u003c/li\u003e\n\u003cli\u003eComments can be posted to articles\u003c/li\u003e\n\u003cli\u003eContact form can be used to send a message to the website owner\u003c/li\u003e\n\u003cli\u003eThe website has a search box for searching articles\u003c/li\u003e\n\u003cli\u003eList of recent articles and categories is auto generated\u003c/li\u003e\n\u003cli\u003eThe source code is modular and easy to extend with new features\u003c/li\u003e\n\u003cli\u003eThe website frontend is based on \u003ca href='https://getbootstrap.com/'\u003eTwitter Bootstrap\u003c/a\u003e and \u003ca href='https://jquery.com/'\u003eJQuery\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003eThe website frontend is valid HTML 5 and has been tested with the \u003ca href='https://validator.nu/'\u003evalidator.nu\u003c/a\u003e tool\u003c/li\u003e\n\u003cli\u003eThe article structure is based on \u003ca href='https://www.w3schools.com/html/html5_semantic_elements.asp'\u003eSemantic Elements\u003c/a\u003e and is SEO friendly\u003c/li\u003e\n\u003cli\u003eThe website is mobile friendly\u003c/li\u003e\n\u003cli\u003eThe website has good browser response time\u003c/li\u003e\n\u003cli\u003eGoogle Analytics tracking code can be easily added for keeping track of website visitors\u003c/li\u003e\n\u003cli\u003eThe website provides scripts for generating Site Maps and for testing the website pages for broken links and HTML 5 validation errors\u003c/li\u003e\n\u003cli\u003eHTML pages can be exported as markdown files\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/div\u003e\n\n\u003ch3\u003eLimitations\u003c/h3\u003e\n\u003cdiv\u003e\n\u003cul\u003e\n\u003cli\u003eThe website does not have a backend. Article content has to be added directly to database using a database management tool such as \u003ca href='https://www.phpmyadmin.net/'\u003ePhpMyAdmin\u003c/a\u003e\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/div\u003e\n\n\u003ch3\u003eRequirements\u003c/h3\u003e\n\u003cp\u003eThe \"Developers Site\" is based on Php and MySQL. It uses the \u003ca href='https://getbootstrap.com/'\u003eTwitter Bootstrap\u003c/a\u003e and \u003ca href='https://jquery.com/'\u003eJQuery\u003c/a\u003e Frontend libraries. The website uses the \u003ca href='https://pear.php.net/package/Mail/'\u003eMail\u003c/a\u003e and \u003ca href='https://pear.php.net/package/Mail_Mime/'\u003eMail Mime\u003c/a\u003e pear packages for sending email. These packages should be installed on your server.\u003c/p\u003e\n\n\u003cp\u003eInstalling the website on your own server requires Php 7.2 and above. The website source code is based on the \u003ca href='https://www.pakjiddat.pk/articles/view/258/pak-php-framework'\u003ePak Php Framework\u003c/a\u003e. The source code is fully commented and compliant with the \u003ca href='https://www.php-fig.org/psr/psr-2/'\u003ePSR-2 coding guidelines\u003c/a\u003e. The source code for the website is modular and easy to extend with new features.\u003c/p\u003e\n\n\u003ch3\u003eSite Map Generation\u003c/h3\u003e\n\u003cp\u003eA Site Map for the website pages can be auto generated by running the command: \u003cb\u003ephp index.php  --application=\"pakjiddat\" --action=\"Generate Site Map\";\u003c/b\u003e. This creates a file sitemap.txt in the data folder. The script also saves all urls to the \u003cb\u003epakphp_test_data\u003c/b\u003e, which allows each url to be checked for broken links and HTML 5 compatibility.\u003c/p\u003e\n\n\u003ch3\u003eMarkdown file Generation\u003c/h3\u003e\n\u003cp\u003eThe website content stored in database can be exported as markdown files by running the command: \u003cb\u003ephp index.php --application=\"pakjiddat\" --action=\"Generate Markdown\";\u003c/b\u003e. This creates Markdown files in the data/markdown folder.\u003c/p\u003e\n\n\u003ch3\u003eHtml file Generation\u003c/h3\u003e\n\u003cp\u003eThe website content stored in database can be exported as HTML files by running the command: \u003cb\u003ephp index.php --application=\"pakjiddat\" --action=\"Generate Html\";\u003c/b\u003e. This creates HTML files in the data/html folder.\u003c/p\u003e\n\n\u003ch3\u003eTesting\u003c/h3\u003e\n\u003cp\u003eAll pages on the \"Developers Site\" website can checked for broken links and validated using the \u003ca href='https://validator.nu/'\u003evalidator.nu\u003c/a\u003e tool. To test the website pages, first enter the list of urls to test in the database table: \u003cb\u003epakphp_test_data\u003c/b\u003e. The table may be auto populated by setting the variable: \u003cb\u003esave_ui_test_data\u003c/b\u003e to \u003cb\u003etrue\u003c/b\u003e in \u003cb\u003epakjiddat/config/Test.php\u003c/b\u003e file. Alternately the Site Map script may be run, which saves all Site Map urls to the database table. Next run the command: \u003cb\u003ephp index.php  --application=\"pakjiddat\" --action=\"Unit Test\";\u003c/b\u003e. This will start the testing of each page listed in the database table.\u003c/p\u003e\n\n\u003ch3\u003eInstallation\u003c/h3\u003e\n\u003cp\u003eThe following steps can be used to install the \"Developers Site\" project on your own server:\u003c/p\u003e\n\u003cdiv\u003e\n  \u003cul\u003e\n    \u003cli\u003eDownload the \u003ca href='https://github.com/nadirlc/developers-site/archive/master.zip'\u003esource code\u003c/a\u003e from GitHub\u003c/li\u003e\n    \u003cli\u003eMove the source code to the document root of a virtual host\u003c/li\u003e\n    \u003cli\u003eCreate a database and import the contents of the file: \u003cb\u003epakjiddat/data/developers-site.sql\u003c/b\u003e to the database. Note down the credentials used for connecting to the database\u003c/li\u003e\n    \u003cli\u003eEnter the database credentials in the file \u003cb\u003epakjiddat/config/RequiredObjects.php\u003c/b\u003e\u003c/li\u003e\n    \u003cli\u003eIn the file: \u003cb\u003epakjiddat/Config.php\u003c/b\u003e, on \u003cb\u003eline 41\u003c/b\u003e enter the domain names that will be used to access the website\u003c/li\u003e\n    \u003cli\u003eCustomize the following variables in the file: \u003cb\u003epakjiddat/config/General.php\u003c/b\u003e. \u003cb\u003e$config['app_name'], $config['dev_mode'] and $config['site_url']\u003c/b\u003e\u003c/li\u003e\n    \u003cli\u003eCustomize the variables in the file: \u003cb\u003epakjiddat/config/Custom.php\u003c/b\u003e. The comments explain what each variable is used for\u003c/li\u003e\n    \u003cli\u003eSet the \u003cb\u003e$config['pear_folder_path']\u003c/b\u003e variable in the file: \u003cb\u003epakjiddat/config/Path.php\u003c/b\u003e. The variable should be set to the path of the \u003ca href='https://pear.php.net/'\u003epear\u003c/a\u003e installation.\u003c/li\u003e\n    \u003cli\u003eVisit the website in a browser\u003c/li\u003e\n    \u003cli\u003eEnter the website articles in the database table: \u003cb\u003ehome_content\u003c/b\u003e. The article should start showing on the website\u003c/li\u003e\n    \u003cli\u003eThe layout and text of the website can be edited in html files inside the folder: \u003cb\u003epakjiddat/ui/html\u003c/b\u003e. For example to edit the website header, the file: \u003cb\u003epakjiddat/ui/html/base/header.html\u003c/b\u003e needs to be edited\u003c/li\u003e\n  \u003c/ul\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpakjiddat%2Fdevelopers-site","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpakjiddat%2Fdevelopers-site","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpakjiddat%2Fdevelopers-site/lists"}