apigee / apigee-devportal-kickstart-drupal

A fast demo and starting point for Apigee Developer Portals for Drupal
https://www.drupal.org/project/apigee_devportal_kickstart
GNU General Public License v2.0
26 stars 34 forks source link

Customization of API docs page #375

Closed KNSivagami closed 4 years ago

KNSivagami commented 4 years ago

We need to do some customisation in the API doc page of the new kickstart module like old drupal 7 portal.

we need something like below

image

In drupal 7 we configured in taxonomy-> smartdocs model. In kickstart it cannot be aligned in tab accordingly.

It is showing image

Kindly help how to change the page view

Thanks in Adavnce

-- SIvagami

kiranjyoth commented 4 years ago

@KNSivagami Are you using 8.1.x or 8.2.x of the module apigee_api_catalog ? This requires custom templating of custom entity / node type. For 8.1.x your naming convention will be something like apigee-entity--apidoc--full.html.twig and if its 8.2.x, Here is a link to naming conventions https://www.drupal.org/docs/theming-drupal/twig-in-drupal/twig-template-naming-conventions#s-nodes Once you theme this template to your design, you will get closer to your original design. Hope that helps!

KNSivagami commented 4 years ago

Hi Jyothi

My Api catalog version is version: '8.x-1.2' project: 'apigee_api_catalog' Drupal is 8.3

Let me know how to proceed

Thanks, Sivagami

From: Jyothi K Reddy notifications@github.com Sent: Friday, May 29, 2020 8:59 PM To: apigee/apigee-devportal-kickstart-drupal apigee-devportal-kickstart-drupal@noreply.github.com Cc: K. N., Sivagami Sivagami.K.N@Honeywell.com; Mention mention@noreply.github.com Subject: [External] Re: [apigee/apigee-devportal-kickstart-drupal] Customization of API docs page (#375)

@KNSivagamihttps://github.com/KNSivagami Are you using 8.1.x or 8.2.x of the module apigee_api_catalog ? This requires custom templating of custom entity / node type. For 8.1.x your naming convention will be something like apigee-entity--apidoc--full.html.twig and if its 8.2.x, Here is a link to naming conventions https://www.drupal.org/docs/theming-drupal/twig-in-drupal/twig-template-naming-conventions#s-nodes Once you theme this template to your design, you will get closer to your original design. Hope that helps!

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHubhttps://github.com/apigee/apigee-devportal-kickstart-drupal/issues/375#issuecomment-636036339, or unsubscribehttps://github.com/notifications/unsubscribe-auth/AO5DIILJPCWTQLF7DXU2H2LRT7IEZANCNFSM4NNZ6QBA.

kiranjyoth commented 4 years ago

@KNSivagami Documentation here shows you basic customization of your portal. https://www.drupal.org/docs/8/modules/apigee-developer-portal-kickstart/customize-your-developer-portal

But for your use case, you may need to create a sub-theme from kickstart theme. follow instructions here to start creating a sub-theme https://github.com/apigee/apigee-devportal-kickstart-drupal/tree/8.x-1.x/themes/custom/apigee_kickstart#creating-an-apigee-kickstart-sub-theme

Once done you will need create or add your custom style sheets to your new sub-theme. Follow templating conventions provided here https://www.drupal.org/docs/theming-drupal/twig-in-drupal/twig-template-naming-conventions#s-nodes to theme your node / page templates.

cnovak commented 4 years ago

Thanks @kiranjyoth for answering, will close ticket but add comments if anything else is needed.