Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation for different views #195

Open
cal-overflow opened this issue Mar 18, 2023 · 1 comment
Open

Documentation for different views #195

cal-overflow opened this issue Mar 18, 2023 · 1 comment

Comments

@cal-overflow
Copy link
Owner

Add documentation for the different views. This can be inside its own markdown file in the repository.

Make sure to include the metadata viewProperties

@cal-overflow
Copy link
Owner Author

cal-overflow commented Apr 16, 2023

Use this comment as a reference for some of the view components. I'll include the view properties with the possible values. I'll also include the default value that is used.

home-view

viewProperties is optional for this section, however certain properties are required for a custom headshot image.

viewProperties:
  headshot:
    image: 'headshot.png'  # any file name is allowed (as long as the file can be found). A placeholder will be used if the image is not found
    styling:
      rounding: [ 'none', 'sm', 'md', 'lg', 'xl', '2xl', '3xl', 'full' ] # default value: 'none'
      objectFit: [ 'contain', 'none', 'cover' 'fill', 'scale-down' ] # default value: 'contain'
  githubPreview: # optional section that can show on the home page. the `user` field will determine what repositories the website will show
    user: 'cal-overflow'
    description: "check out my public github repositories"

post-view

viewProperties is completely optional for this section

viewProperties:
  featureImageStyling: # styles applied to the feature image (applies to only this post!)
    rounding: [ 'none', 'sm', 'md', 'lg', 'xl', '2xl', '3xl', 'full' ] # default value: 'none'
    objectFit: [ 'contain', 'none', 'cover' 'fill', 'scale-down' ] # default value: 'contain'

post-feed

viewProperties is completely optional for this section

viewProperties:
  imageStyling: # styles applied to the feature images in the post previews (applies to only this section!)
    rounding: [ 'none', 'sm', 'md', 'lg', 'xl', '2xl', '3xl', 'full' ] # default value: 'none'
    objectFit: [ 'contain', 'none', 'cover' 'fill', 'scale-down' ] # default value: 'contain'

contact-view

‼️ viewProperties is required for this section

viewProperties:
  emailAddress: [email protected] # Any valid email address will work. This is the email address where contact requests will be sent

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant