{"id":17225909,"url":"https://github.com/zopyx/eteaching.org","last_synced_at":"2025-08-08T02:44:28.100Z","repository":{"id":12267367,"uuid":"14887132","full_name":"zopyx/eteaching.org","owner":"zopyx","description":null,"archived":false,"fork":false,"pushed_at":"2013-12-04T09:47:34.000Z","size":616,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-24T06:15:33.205Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zopyx.png","metadata":{"files":{"readme":"README.txt","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-12-03T08:03:49.000Z","updated_at":"2013-12-04T09:48:39.000Z","dependencies_parsed_at":"2022-08-20T22:21:01.442Z","dependency_job_id":null,"html_url":"https://github.com/zopyx/eteaching.org","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zopyx%2Feteaching.org","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zopyx%2Feteaching.org/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zopyx%2Feteaching.org/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zopyx%2Feteaching.org/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zopyx","download_url":"https://codeload.github.com/zopyx/eteaching.org/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245508797,"owners_count":20626840,"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":[],"created_at":"2024-10-15T04:14:47.693Z","updated_at":"2025-03-25T17:25:02.658Z","avatar_url":"https://github.com/zopyx.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"================================\nPlone 4 buildout for developers\n================================\n\n.. contents ::\n\nIntroduction\n------------\n\n`Buildout \u003chttp://www.buildout.org\u003e`_ is a tool which automatically downloads, installs and configures Python software.\nPlone developers prefer uses buildout based installation method - it makes it easy to work with source code and developing your own Plone add-ons.\n\nFor production site installations please use `standard Plone installer \u003chttp://plone.org/download\u003e`_.\n\nPrerequisitements\n-----------------\n\nWhat you need in order to use developer buildout with Plone 4\n\n* Experience using command line tools\n\n* Experience using a text editor to work with configuration files (``buildout.cfg``)\n\n* GCC compiler suite to build native Python extensions (Zope contains C code for optimized parts)\n\n* Python 2.6 (other versions are *not* ok for Plone 4)\n\n* Python Imaging Library installed for your Python interpreter (more below)\n\n* Python `Distribute \u003chttp://pypi.python.org/pypi/distribute\u003e`_ installation tool, provided by your operating system\n  or installed by hand\n\nRead below from operating system specific instructions how to install these dependencies.\n\nFeatures\n--------\n\nThis buildout provides\n\n* Zope start up scripts (one instance)\n\n* ``paster`` command for creating Plone add-ons (different from system-wide installation)\n\n* `test \u003chttp://plone.org/documentation/manual/plone-community-developer-documentation/testing-and-debugging/unit-testing\u003e`_ command for running automatic test suites \n\n* `i18ndude \u003chttp://pypi.python.org/pypi/i18ndude\u003e`_  for managing text string translations in Python source code \n\n* `omelette \u003chttp://pypi.python.org/pypi/collective.recipe.omelette\u003e`_ buildout recipe which makes Python egg source code more browseable by using symlinks\n\n* `mr.developer \u003chttp://pypi.python.org/pypi/mr.developer\u003e`_ command for managing source code checkouts and updates with buildout repeatable manner\n\n* `collective.developermanual \u003chttp://plone.org/documentation/manual/plone-community-developer-documentation\u003e`_ - community managed developer manual for Plone\n  in source code form, ready for contributions\n\nCreating Plone 4 buildout installation\n------------------------------------------\n\nInstall ZopeSkel template package for your system-wide Python using Distribute::\n\n easy_install ZopeSkel\n \n... or upgrade existing installation::\n\n easy_install -U ZopeSkel\n\nYou probably got here by running something like (replace *myplonefoldername* with the target folder where you want to Plone to be installed)::\n\n zopeskel plone4_buildout myplonefoldername\n\nNow, you need to run (please see remarks regarding your operating system below)::\n\n python bootstrap.py\n\nThis will create ``bin`` folder and ``bin/buildout`` script. If you any time want to change Python interpreter\nassociated with buildout, or you need to update ``buildout`` script itself to newer version please rerun ``bootsrap.py``.\n\nNow you can run buildout script which will download all Python packages\n(.egg files) and create ``parts/`` and ``var/`` folder structure ::\n\n  bin/buildout\n\nIf this succesfully completes you can start buildout in foreground mode (Press *CTRL+C* to terminate)::\n\n  bin/instance fg \n\nNow you can login to your site\n\n  http://localhost:8080\n\nThe default user is ``admin`` with password ``admin``. \nAfter initial start-up admin password is stored in Data.fs databse file and value in ``buildout.cfg`` is ignored.\nPlease follow `these instructions to change admin password \u003chttp://manage.plone.org/documentation/kb/changing-the-admin-password\u003e`_.\n\nNext steps\n----------\n\nCreating your first add-on\n==========================\n\nPlone 4 buildout comes with ``bin/paster`` command for creating Plone add-ons.\n\n.. note ::\n\n\tWhen working with Plone add-ons, use paster command from buildout bin folder, not the system wide paster command.\n\nCreate theme (applies for Plone 4 also)::\n\t\n\tbin/zopeskel plone3_theme plonetheme.mythemeid\n\t\nCreate Archetypes based content types package::\n\n\tbin/zopeskel archetype mycompanyid.content\n\nCreate other Plone customizations::\n\n\tbin/zopeskel plone mycompanyid.mypackageid\n\nMore info\n\n* `Instructions how to use Paster command to create your own add-ons \u003chttp://collective-docs.plone.org/tutorials/paste.html\u003e`_ \n\nManaging source code checkouts with buildout\n=============================================\n\n`mr.developer buildout extension \u003chttp://pypi.python.org/pypi/mr.developer\u003e`_ command which can be used with buildout to manage your source code repositories\n*mr.developer* makes source code checkout from multiple repositores a repeatable task.\n\nOperating system specific instructions \n-------------------------------------------\n\nUbuntu/Debian\n==============\n\nTested for Ubuntu 10.10.\n\nInstall prerequisitements::\n\n\tsudo apt-get install python2.6 python-imaging wget build-essential python2.6-dev python-setuptools\n\teasy_install ZopeSkel\n\nOSX\n====\n\nInstall `OSX development tools (XCode) \u003chttp://developer.apple.com/\u003e`_ from Apple.\n\nInstall `Macports \u003chttp://www.macports.org/\u003e`_.\n\nThen the following installs dependencies::\n\n\tsudo port install python26 py26-pil py26-distribute wget \n\teasy_install ZopeSkel\n\nWhen you run ``bootstrap.py``use the following command to make sure you are using Python interpreter from Macports::\n\n\tpython2.6 bootstrap.py\n\nWindows\n========\n\nMicrosoft Windows systems is problematic because\nit does not provide to Microsoft Visual C compiler (commercial) which is\nrequired to build native Python extensions.\n\nPlease read\n\n* http://plone.org/documentation/kb/using-buildout-on-windows\n\nOther\n-----\n\nThe orignal copy of these instructions is available at\n\n* https://svn.plone.org/svn/collective/ZopeSkel/trunk/zopeskel/templates/plone4_buildout/README.txt\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzopyx%2Feteaching.org","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzopyx%2Feteaching.org","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzopyx%2Feteaching.org/lists"}