Forum Discussion

Simon_L's avatar
Simon_L
Brass Contributor
Feb 15, 2019

Replicate Microsoft support article using SharePoint modern pages

Hi all,

 

I'm wanting to create guides in Sharepoint that is available within Teams. This requires I use modern pages. I like how MS support articles are formatted and wanting to know if it's possible to replicate it using SharePoint modern pages.

 

I've tried to achieve this by using text and image web parts. But there are some things I'm struggling with:

 

  1. Can't left justify images.
  2. Numbered lists have to begin at 1 (I'm adding image parts between text parts and would like to continue numbering from previous text part).

 

Has anyone else managed to do what I'm trying to achieve? Is it possible?

7 Replies

  • Rachel_Davis's avatar
    Rachel_Davis
    Steel Contributor

    I get what you're trying to do cuz I tried to do the same thing. The difficulty is the the Microsoft documentation pages are actual web pages using HTML, which SharePoint is not. 

     

    So here's where I ended up.

    • Manual numbering - it's lame but it works
    • Use 2 columns - put the text in the one and the image in the other, then use sections for each step to keep the text parallel to the image. I tried using spacer web parts to fill the gaps and those disappear in mobile view, but that isn't necessary if you use a new section for each step. Down side to this is that large images can create gaps that fall off screen, so make sure it's clear to your users that they need to keep scrolling down. Alternating section background colors can help with this. Using a consistent size for your images also helps, but isn't always possible depending on your content. ALWAYS CHECK HOW THE LAYOUT LOOKS ON SMALLER SCREENS. 
    • Or if you want a single column of content down your page, skip the numbering altogether - use heading styles for major steps and numbering for sub-steps.

    Unfortunately, we can't do anything about justifying the image. Using a consistent image size or at least a consistent width helps keep them in line, particularly if you go with the 2 column method.

     

    I eventually went with bullets 1 and 3. I use manual numbering for the main heading steps (cuz those rarely change) and autonumbering for the detailed sub steps. It's fast, easy and always displays properly regardless of screen size. 

    • Simon_L's avatar
      Simon_L
      Brass Contributor
      Ah, very nice way of tackling things, particularly the two column method.
      The manual numbering I don't mind, as my guides won't have that many steps (for now). But the image justification just drove me nuts. I'll put in a feature request for that.

      Thanks for your response Rachel.
      • Rachel_Davis's avatar
        Rachel_Davis
        Steel Contributor

        Simon_LGiven the way modern pages are structured with everything in separate web parts, I agree that we need an option to continue numbering from a previous section. If you post a link for your suggestion here, I'll vote for it! 

  • Eva Vogel's avatar
    Eva Vogel
    Steel Contributor
    Hi Simon,
    I recommend to create a community site with th modern News pages. It’s more than the old wiki pages and contents so much better Webportal, e.g the links to posted Microsoft articles with already containing images! Why doing that twice? Greets, Eva
    • Simon_L's avatar
      Simon_L
      Brass Contributor
      I'm only wanting to copy the layout and format, not the content. I'm writing guides for non-Microsoft products.
      • Eva Vogel's avatar
        Eva Vogel
        Steel Contributor
        Hi Simon,
        I don’t think Microsoft lets you using their layout and format. Why not using SharePoint?