{"action":"created","comment":{"url":"https://api.github.com/repos/plone/documentation/pulls/comments/65502978","id":65502978,"diff_hunk":"@@ -0,0 +1,181 @@\n+=======================================\n+Customize the Barceloneta default theme\n+=======================================\n+\n+TODO\n+\n+\n+Heading\n+-------\n+\n+TODO\n+\n+\n+Subheading\n+++++++++++\n+\n+TODO\n+\n+\n+Subheading\n+++++++++++\n+\n+TODO\n+\n+\n+Heading\n+-------\n+\n+TODO\n+\n+\n+Introduction\n+------------\n+\n+Target group\n+++++++++++++\n+\n+A Systems integrator with average knowledge about Plone. Aims to theme a Plone site. \n+\n+\n+Aim\n++++\n+\n+In this tutorial you will learn how to build a custom theme for your website by changing several elements of Plone. You will learn where to find and how to customise different building blocks in Plone while keeping the basic concepts and structure intact. \n+\n+Demarcation\n++++++++++++\n+\n+This is not about creating a standalone theme which behaves independently from Plone UI concepts. If you plan to do this, you should read the next scenario.\n+\n+Requirements\n+++++++++++++\n+\n+We assume that you want to keep your customisations in filesystem code. You are  familiar with how to create and register an egg to accommodate the customisations. You can e.g. create such an egg by using mr.bob and following the mr.bob documentation on pypi <https://github.com/plone/bobtemplates.plone>`_ and picking the theme option.\n+\n+\n+\n+Getting started with the Basics\n+-------------------------------\n+\n+New logo\n+++++++++\n+\n+Probably the very first thing you want to change in a new site is the logo and the favicon. Let’s start with the logo.\n+\n+\n+First we override the existing logo using `z3c.jbot <https://pypi.python.org/pypi/z3c.jbot>`_. Hierfür gibt es in unserem neu erstellten Paket bereits den Ordner ``overrides`` in ``your.egg/src/your/egg/browser/``.\n+\n+::\n+\n+    $ cd your.egg/src/your/egg/browser/overrides/\n+    $ cp fromplonepositionoflogo .\n+    $ mv logo.png Products.CMFPlone.skins.plone_images.logo.png\n+\n+We assume you \n+Anschließend kann die Instanz neu gestartet werden, eine Plone-Site erstellt und ``vs.base`` aktiviert werden.\n+\n+\n+Change the favicon\n+++++++++++++++++++\n+\n+The favicon is stored in a different place. To exchange it, you need to do…\n+\n+#get your favicon.ico from anywhere and follow the steps explained in the step above.\n+\n+   $ mv your_favicon.ico Products.CMFPlone.skins.plone_images.favicon.ico\n+\n+\n+Play with the variables!\n+++++++++++++++++++++++++\n+\n+Now the last thing to make the site really look differently is to change a few styles to match your desired CI. Plone already supports a few parameters to customise typical elements. These variables are located … and can be customised like this…\n+\n+You can set the LESS variables values in the \"plone.lessvariables\" record in your profile's registry.xml.\n+Note: you will have to re-build your resources.\n+\n+\n+Your own custom css file\n+++++++++++++++++++++++++\n+\n+While the above variables allow you quite some control, it is quite likely that there are style elements that cannot be controlled by them. In this case, it may be a good solution to just add a bunch of your own styles in addition to the default styles provided by Plone. With these styles you can add more styling or override existing styling rules in css. \n+\n+Note: While Plone supports “less” syntax in style files, you can of course also write plain css only.\n+\n+These steps show you how to register your own styles file so that it gets included into the Plone theme.\n+\n+code here\n+\n+Note: If you are changing styles in your style file, remember to recompile (describe the actual steps necessary from changing a style in the file to actually seeing the difference in your browser).\n+\n+\n+Change CSS that’s already there\n++++++++++++++++++++++++++++++++\n+\n+The previous steps should already have gotten your site into a quite decent state. You can do already a lot with custom css, but as soon as your custom css file get’s quite long, things become crowded and you might get a desire for more structure. Instead of now adding even more of your own custom css files and slowly duplicating most of the css, you can actually also exchange existing Plone css.\n+\n+Plone keeps its css in a very well structured, componentized way. If you want to change the styling for a certain area or component, chances are good that you will find them already grouped in a dedicated less file. \n+\n+Take a look what’s available here… (where are the barceloneta less files?)\n+\n+If you can identify the styles group you want to exchange, perform the following steps to unregister the original one and register your own.\n+\n+\n+Customise Special Elements\n+--------------------------\n+\n+Change the toolbar logo\n++++++++++++++++++++++++\n+\n+By now you have probably noticed that there are a few more elements that you might want to alter. One is the little Plone logo in the toolbar. If you want to change that, you can do that by …\n+\n+code here\n+\n+ \n+The Omnipresent Icons\n++++++++++++++++++++++\n+\n+Plone doesn’t use images as icons for content types or actions anymore. Instead it uses a fontello font which is configured to contain all the icons needed as characters. If you want to change these, yo can of course provide your own and override via css, but you can also upload the font definition file to fontello, reconfigure it there and readd the modified font file to your customisation.\n+\n+Here is how you upload and modify the fontello font file:\n+\n+code here\n+\n+Here is how you override the font in your own code:\n+\n+code here\n+","path":"adapt-and-extend/theming/customize-barceloneta.rst","position":147,"original_position":147,"commit_id":"8f4630f66b35bbcbb47600153227b9e78d7b2f45","original_commit_id":"8f4630f66b35bbcbb47600153227b9e78d7b2f45","user":{"login":"svx","id":358860,"avatar_url":"https://avatars.githubusercontent.com/u/358860?v=3","gravatar_id":"","url":"https://api.github.com/users/svx","html_url":"https://github.com/svx","followers_url":"https://api.github.com/users/svx/followers","following_url":"https://api.github.com/users/svx/following{/other_user}","gists_url":"https://api.github.com/users/svx/gists{/gist_id}","starred_url":"https://api.github.com/users/svx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/svx/subscriptions","organizations_url":"https://api.github.com/users/svx/orgs","repos_url":"https://api.github.com/users/svx/repos","events_url":"https://api.github.com/users/svx/events{/privacy}","received_events_url":"https://api.github.com/users/svx/received_events","type":"User","site_admin":false},"body":"where is the code ?","created_at":"2016-06-02T08:37:36Z","updated_at":"2016-06-02T08:37:36Z","html_url":"https://github.com/plone/documentation/pull/386#discussion_r65502978","pull_request_url":"https://api.github.com/repos/plone/documentation/pulls/386","_links":{"self":{"href":"https://api.github.com/repos/plone/documentation/pulls/comments/65502978"},"html":{"href":"https://github.com/plone/documentation/pull/386#discussion_r65502978"},"pull_request":{"href":"https://api.github.com/repos/plone/documentation/pulls/386"}}},"pull_request":{"url":"https://api.github.com/repos/plone/documentation/pulls/386","id":46397238,"html_url":"https://github.com/plone/documentation/pull/386","diff_url":"https://github.com/plone/documentation/pull/386.diff","patch_url":"https://github.com/plone/documentation/pull/386.patch","issue_url":"https://api.github.com/repos/plone/documentation/issues/386","number":386,"state":"open","locked":false,"title":"WIP Feature/theming scenarios","user":{"login":"Gomez","id":48724,"avatar_url":"https://avatars.githubusercontent.com/u/48724?v=3","gravatar_id":"","url":"https://api.github.com/users/Gomez","html_url":"https://github.com/Gomez","followers_url":"https://api.github.com/users/Gomez/followers","following_url":"https://api.github.com/users/Gomez/following{/other_user}","gists_url":"https://api.github.com/users/Gomez/gists{/gist_id}","starred_url":"https://api.github.com/users/Gomez/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Gomez/subscriptions","organizations_url":"https://api.github.com/users/Gomez/orgs","repos_url":"https://api.github.com/users/Gomez/repos","events_url":"https://api.github.com/users/Gomez/events{/privacy}","received_events_url":"https://api.github.com/users/Gomez/received_events","type":"User","site_admin":false},"body":"Work done at the Theming Sprint in Munich by @santonelli & @pilz ","created_at":"2015-09-30T12:52:04Z","updated_at":"2016-06-02T08:37:36Z","closed_at":null,"merged_at":null,"merge_commit_sha":"bfe059b9fb46df7e18e2cf121f367a1a6ade9587","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/plone/documentation/pulls/386/commits","review_comments_url":"https://api.github.com/repos/plone/documentation/pulls/386/comments","review_comment_url":"https://api.github.com/repos/plone/documentation/pulls/comments{/number}","comments_url":"https://api.github.com/repos/plone/documentation/issues/386/comments","statuses_url":"https://api.github.com/repos/plone/documentation/statuses/8f4630f66b35bbcbb47600153227b9e78d7b2f45","head":{"label":"plone:feature/theming-scenarios","ref":"feature/theming-scenarios","sha":"8f4630f66b35bbcbb47600153227b9e78d7b2f45","user":{"login":"plone","id":72034,"avatar_url":"https://avatars.githubusercontent.com/u/72034?v=3","gravatar_id":"","url":"https://api.github.com/users/plone","html_url":"https://github.com/plone","followers_url":"https://api.github.com/users/plone/followers","following_url":"https://api.github.com/users/plone/following{/other_user}","gists_url":"https://api.github.com/users/plone/gists{/gist_id}","starred_url":"https://api.github.com/users/plone/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/plone/subscriptions","organizations_url":"https://api.github.com/users/plone/orgs","repos_url":"https://api.github.com/users/plone/repos","events_url":"https://api.github.com/users/plone/events{/privacy}","received_events_url":"https://api.github.com/users/plone/received_events","type":"Organization","site_admin":false},"repo":{"id":16646125,"name":"documentation","full_name":"plone/documentation","owner":{"login":"plone","id":72034,"avatar_url":"https://avatars.githubusercontent.com/u/72034?v=3","gravatar_id":"","url":"https://api.github.com/users/plone","html_url":"https://github.com/plone","followers_url":"https://api.github.com/users/plone/followers","following_url":"https://api.github.com/users/plone/following{/other_user}","gists_url":"https://api.github.com/users/plone/gists{/gist_id}","starred_url":"https://api.github.com/users/plone/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/plone/subscriptions","organizations_url":"https://api.github.com/users/plone/orgs","repos_url":"https://api.github.com/users/plone/repos","events_url":"https://api.github.com/users/plone/events{/privacy}","received_events_url":"https://api.github.com/users/plone/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/plone/documentation","description":"Plone Documentation","fork":false,"url":"https://api.github.com/repos/plone/documentation","forks_url":"https://api.github.com/repos/plone/documentation/forks","keys_url":"https://api.github.com/repos/plone/documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/plone/documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/plone/documentation/teams","hooks_url":"https://api.github.com/repos/plone/documentation/hooks","issue_events_url":"https://api.github.com/repos/plone/documentation/issues/events{/number}","events_url":"https://api.github.com/repos/plone/documentation/events","assignees_url":"https://api.github.com/repos/plone/documentation/assignees{/user}","branches_url":"https://api.github.com/repos/plone/documentation/branches{/branch}","tags_url":"https://api.github.com/repos/plone/documentation/tags","blobs_url":"https://api.github.com/repos/plone/documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/plone/documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/plone/documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/plone/documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/plone/documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/plone/documentation/languages","stargazers_url":"https://api.github.com/repos/plone/documentation/stargazers","contributors_url":"https://api.github.com/repos/plone/documentation/contributors","subscribers_url":"https://api.github.com/repos/plone/documentation/subscribers","subscription_url":"https://api.github.com/repos/plone/documentation/subscription","commits_url":"https://api.github.com/repos/plone/documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/plone/documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/plone/documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/plone/documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/plone/documentation/contents/{+path}","compare_url":"https://api.github.com/repos/plone/documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/plone/documentation/merges","archive_url":"https://api.github.com/repos/plone/documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/plone/documentation/downloads","issues_url":"https://api.github.com/repos/plone/documentation/issues{/number}","pulls_url":"https://api.github.com/repos/plone/documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/plone/documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/plone/documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/plone/documentation/labels{/name}","releases_url":"https://api.github.com/repos/plone/documentation/releases{/id}","deployments_url":"https://api.github.com/repos/plone/documentation/deployments","created_at":"2014-02-08T15:33:54Z","updated_at":"2016-03-05T10:58:42Z","pushed_at":"2016-06-02T07:44:12Z","git_url":"git://github.com/plone/documentation.git","ssh_url":"git@github.com:plone/documentation.git","clone_url":"https://github.com/plone/documentation.git","svn_url":"https://github.com/plone/documentation","homepage":"http://docs.plone.org","size":24395,"stargazers_count":14,"watchers_count":14,"language":"HTML","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":72,"mirror_url":null,"open_issues_count":104,"forks":72,"open_issues":104,"watchers":14,"default_branch":"5.0"}},"base":{"label":"plone:5.0","ref":"5.0","sha":"45d4573174368666eb6e02eaeb80bbc6a24e38f3","user":{"login":"plone","id":72034,"avatar_url":"https://avatars.githubusercontent.com/u/72034?v=3","gravatar_id":"","url":"https://api.github.com/users/plone","html_url":"https://github.com/plone","followers_url":"https://api.github.com/users/plone/followers","following_url":"https://api.github.com/users/plone/following{/other_user}","gists_url":"https://api.github.com/users/plone/gists{/gist_id}","starred_url":"https://api.github.com/users/plone/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/plone/subscriptions","organizations_url":"https://api.github.com/users/plone/orgs","repos_url":"https://api.github.com/users/plone/repos","events_url":"https://api.github.com/users/plone/events{/privacy}","received_events_url":"https://api.github.com/users/plone/received_events","type":"Organization","site_admin":false},"repo":{"id":16646125,"name":"documentation","full_name":"plone/documentation","owner":{"login":"plone","id":72034,"avatar_url":"https://avatars.githubusercontent.com/u/72034?v=3","gravatar_id":"","url":"https://api.github.com/users/plone","html_url":"https://github.com/plone","followers_url":"https://api.github.com/users/plone/followers","following_url":"https://api.github.com/users/plone/following{/other_user}","gists_url":"https://api.github.com/users/plone/gists{/gist_id}","starred_url":"https://api.github.com/users/plone/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/plone/subscriptions","organizations_url":"https://api.github.com/users/plone/orgs","repos_url":"https://api.github.com/users/plone/repos","events_url":"https://api.github.com/users/plone/events{/privacy}","received_events_url":"https://api.github.com/users/plone/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/plone/documentation","description":"Plone Documentation","fork":false,"url":"https://api.github.com/repos/plone/documentation","forks_url":"https://api.github.com/repos/plone/documentation/forks","keys_url":"https://api.github.com/repos/plone/documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/plone/documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/plone/documentation/teams","hooks_url":"https://api.github.com/repos/plone/documentation/hooks","issue_events_url":"https://api.github.com/repos/plone/documentation/issues/events{/number}","events_url":"https://api.github.com/repos/plone/documentation/events","assignees_url":"https://api.github.com/repos/plone/documentation/assignees{/user}","branches_url":"https://api.github.com/repos/plone/documentation/branches{/branch}","tags_url":"https://api.github.com/repos/plone/documentation/tags","blobs_url":"https://api.github.com/repos/plone/documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/plone/documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/plone/documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/plone/documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/plone/documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/plone/documentation/languages","stargazers_url":"https://api.github.com/repos/plone/documentation/stargazers","contributors_url":"https://api.github.com/repos/plone/documentation/contributors","subscribers_url":"https://api.github.com/repos/plone/documentation/subscribers","subscription_url":"https://api.github.com/repos/plone/documentation/subscription","commits_url":"https://api.github.com/repos/plone/documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/plone/documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/plone/documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/plone/documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/plone/documentation/contents/{+path}","compare_url":"https://api.github.com/repos/plone/documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/plone/documentation/merges","archive_url":"https://api.github.com/repos/plone/documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/plone/documentation/downloads","issues_url":"https://api.github.com/repos/plone/documentation/issues{/number}","pulls_url":"https://api.github.com/repos/plone/documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/plone/documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/plone/documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/plone/documentation/labels{/name}","releases_url":"https://api.github.com/repos/plone/documentation/releases{/id}","deployments_url":"https://api.github.com/repos/plone/documentation/deployments","created_at":"2014-02-08T15:33:54Z","updated_at":"2016-03-05T10:58:42Z","pushed_at":"2016-06-02T07:44:12Z","git_url":"git://github.com/plone/documentation.git","ssh_url":"git@github.com:plone/documentation.git","clone_url":"https://github.com/plone/documentation.git","svn_url":"https://github.com/plone/documentation","homepage":"http://docs.plone.org","size":24395,"stargazers_count":14,"watchers_count":14,"language":"HTML","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":72,"mirror_url":null,"open_issues_count":104,"forks":72,"open_issues":104,"watchers":14,"default_branch":"5.0"}},"_links":{"self":{"href":"https://api.github.com/repos/plone/documentation/pulls/386"},"html":{"href":"https://github.com/plone/documentation/pull/386"},"issue":{"href":"https://api.github.com/repos/plone/documentation/issues/386"},"comments":{"href":"https://api.github.com/repos/plone/documentation/issues/386/comments"},"review_comments":{"href":"https://api.github.com/repos/plone/documentation/pulls/386/comments"},"review_comment":{"href":"https://api.github.com/repos/plone/documentation/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/plone/documentation/pulls/386/commits"},"statuses":{"href":"https://api.github.com/repos/plone/documentation/statuses/8f4630f66b35bbcbb47600153227b9e78d7b2f45"}}}}
{"actor":{"display_login":"svx"}}